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DDP-»51 6 General Purpose Computer 



SECTION I 
INTRODUCTION 



The User's Guide is intended to familiarize you with the operation of the DDP-516 
computer. From a user's point of view, the DDP-516 computer is a relatively simple device 
to operate. Its movable control console is designed to allow complete operator freedom 
which provides for easy, error-free operation. The comprehensive software package sup- 
plied with the DDP-516 includes a FORTRAN IV compiler, a DAP-1 6 assembler , a variety 
of utility routines and an extensive subroutine library. Furthermore, with each DDP-516, 
Honeywell provides a complete library of instruction manuals and program listings that tell 
the programmer/operator all he needs to know about preparing and using FORTRAN IV and 
DAP-1 6 programs. 

The FORTRAN IV and DAP- 16 Manuals (3C Doc. No. 130071634 and 130071629) 
present complete instructions for preparing programs in the two DDP-516 source languages. 
The Programmers Reference Manual (3C Doc. No. 130071585) lists and describes all the 
instructions in the DDP-516 repertoire. 

In the User's Guide, you will find detailed instructions for using your computer and 
its software package. The guide is sectionalized for easy referencing so that information 
you will refer to again and again can be found easily. At the same time, the user can pro- 
gressively increase his knowledge of the DDP-516 by reading the sections in the order they 
appear in the guide. Sections II and III will be of greatest interest initially. Section II 
explains the function of each of the controls on the control console and presents a few simple 
procedures for using them to perform basic, manual operations. Section III lists, by type 
and function, all the programs in your software package and describes the formats in which 
they are punched on paper tape. 

Section IV presents step-by- step instructions for generating self-loading system 
tapes that are tailored to your installation. These tapes will enable you to use your DDP-516 
efficiently and conveniently. Section V contains generalized operating procedures for using 
your newly generated system tapes and for using some of the more frequently used utility 
programs. The remainder of the User's Guide contains reference material designed to help 
you make effective use of your DDP-516 and its software package. 
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SECTION II 
CONTROL CONSOLE 

The basic DDP-516 computer system includes a main frame, a control console and 
a typewriter. In addition to these standard devices, your installation may include any or 
all of the following peripheral devices: 

High-speed paper tape reader Line printer 

High-speed paper tape punch One or more magnetic tape units 

Card-reader One or two disc file units 

The DDP-516 Programmers Reference Manual (3C Doc. No. 130071585) and the 
appropriate peripheral device option manuals contain operating instructions for each device, 
whether standard or optional. The software package contains the input/output subroutines 
required for using the devices included in your installation. 

The control console (Figure 2-1) includes the controls and indicators for normal 
system operation. These controls and indicators are listed and described in Tables 2-1 
through 2-3. 
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Figure 2-1. DDP-516 Control Panel 
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Table 2-1. 
Registers Displayed on DDP-516 Control Panel 



Register 


Bits 


Display- 


X 


1-16 


Index Register 


A 


1-16 


Register A (primary arithmetic and logic register). 


B 


1-16 


Register B (secondary arithmetic and logic register). 


OP 


1-16 


State of key flip-flops in system, (Refer to Table 2-4. ) 


P/Y 


1-16 


Register Y (memory address register). When the 
computer is operating in the memory access (MA) 
mode, Registers P and Y contain the same address. 
When in the single instruction (SI) or RUN mode 
Register P contains an address which is one greater 
than the address contained in Register Y. 


M 

— 


1-16 


Register M (memory buffer register) contains the 
contents of that memory location specified by 
Register Y. 



Table 2-2. 
Function of Control-Panel Pushbuttons 



Pushbutton 



16 Indicator 

CLEAR 
POWER -ON 

POWER -OFF 
X 

A 
B 

OP 
P/Y 



M 

MSTR CEEAJR 

START 



Function 



Enter or display data. A "ONE" is indicated when pushbutton/ 
indicator is illuminated. A "ZERO" is indicated when pushbutton/ 
indicator is not illuminated. 

Clears displayed registers (A, B, P/Y or M only). 

Applies power to main frame. The indicator is illuminated when 
power is applied. 

Removes power from main frame. 

Displays contents of index register. (Data can be entered into 

Register X via location 00000 o . ) 

8 

Displays and permits alterations in contents of Register A. 
Displays and permits alterations in contents of Register B. 
Displays state of key flip-flops in the system. 

Displays and permits alterations in contents of Register P and Y, 
(Registers P and Y contain the same address when the computer 
is in the memory access (MA) mode. Register P contains an 
address which is one higher than that contained in Register Y 
when the computer is in the single instruction (SI) or RUN modes.) 

Displays and permits alterations in contents of Register M. 

Clears Registers A, B, P, Y and M; sets all timing to that state 
existing following a HLT (halt). Initializes standard peripheral 
devices and options. 

Starts machine in all modes. Indicator is illuminated when 
machine is in RUN mode. 
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Table "2-3. 
Function of Control-Panel Selector Switches 



Switch 


Position 


Function 


SENSE 1-2-3-4 




Enables altering the course of a program via 
switch interrogation during program operation. 




Up 


Switches are set. 




Down 


Switches are reset. 


PFI/PFH 
(Power Fail Interrupt/ 
Power Fail Halt) 


PFI 


Allows the machine to cause a program in- 
terrupt when power fails. 




PFH 


Allows the machine to halt when power fails. 


STORE/FETCH 


STORE 


Enables data to be written into memory when 
the computer is in the MA mode. 




FETCH 


Enables data to be read out of memory when 
the computer is in the MA mode. 


P/P+l 


P 


Enables accessing a specific memory location 
when the computer is in the MA mode. 




P+l 


Enables accessing consecutive memory loca- 
tions when the computer is in the MA mode. 


MA/SI/RUN 
(Memory Access/ 
Single Instruction/ 
Run) 


MA 
SI 


Enables data to be written into or read from a 
location in memory and disables the protection 
for locations 1-17«. 

Enables step-by- step execution of a program. 




RUN 


Enables normal operating mode, 



Data within memory and several of the main frame registers can be monitored on 
the control panel. Data can also be manually entered into memory and several registers 
from the control panel. Procedures for initializing the system, reading out and entering 
data into memory and the main frame registers are provided in the following paragraphs. 

SYSTEM INITIALIZATION 

The system can be initialized by depressing the MASTER CLEAR pushbutton. This 
operation has no effect on the contents of memory or Register X. The MASTER CLEAR 
function is also performed when power is applied to the system via the POWER -ON 
pushbutton. 

REGISTER DISPLAY 

The contents of Register X, A, B, OP, P/Y, or M can be displayed by depressing 
the appropriate REGISTER pushbutton. The contents of the selected register is displayed 
on the 16 pushbutton/indicators. Refer to Table 2-4 for the significance of the OP display. 
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REGISTER LOAD 

Data is entered into Register A, B, P/Y, or M as follows, 

a. Depress the appropriate REGISTER pushbutton. 

b. Depress the CLEAR pushbutton. 

c. Enter the desired data by depressing the appropriate pushbutton /indicator s 
(1 through 16). / 

(Data can be entered into Register X by addressing location 000000^ and entering 
the data into that location. For the procedure to enter data into memory, refer to the 
paragraph on Memory Load in this section. ) 

Table 2-4. 
OP Display 



Bit 


Significance 


Bit 


Significance 


1 


Tl, timing level 1 


9 


PI, permit interrupt 


2 


T2, timing level 2 


10 


Unassigned 


3 


T3, timing level 3 


11 


ML, memory lockout (option) 


4 


T4, timing level 4 


12 


EA, extended addressing (bank 
switching option) 


5 


F, fetch cycle 


13 


DP, double precision (option) 


6 


I, indirect cycle 


14 


Unassigned 


7 


A, execute cycle 


15 


MP, memory parity error 


8 


C, c-bit 


16 


P, I/O parity error 



MEMORY DISPLAY 

The contents of any memory location is displayed as follows. 

a. Set MA/SI/RUN switch to MA. 

b. Set FETCH/STORE switch to FETCH. 

c. Set P/P4-1 switch to P. 

d. Depress REGISTER-P/Y pushbutton. 

e. Depress CLEAR pushbutton. 

f. Depress the appropriate pushbutton/indicators (1 through 16) to designate the 
octal address of the memory location containing the data to be displayed. 

g. Depress REGISTER -M pushbutton. 

h. Depress START pushbutton. The contents of the addressed memory location 
will be displayed on the pushbutton/indicators (1 through 16). 

The contents of successive memory locations can be displayed as follows. 

i. Set P/P+l switch to P + l. 

j. Depress the START pushbutton. Each time the START pushbutton is depressed 
the contents of the next memory location is displayed. 
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MEMORY LOAD 

Data is entered into any memory location as follows. 

a. Set MA/SI/RUN switch to MA. 

b. Set FETCH/STORE switch to STORE. 

c. Set P/P+l switch to P. 

d. Depress REGISTER-P/Y pushbutton. 

e. Depress CLEAR pushbutton. 

f. Depress the appropriate pushbutton/ indicators to designate the octal address of 
the memory location to be loaded. 

g. Depress REGISTER-M pushbutton. 

h. Depress CLEAR pushbutton. ! 

i. Depress the appropriate pushbutton /indicators to enter the desired data into the 

addressed location. 

j. Depress START pushbutton. 

The desired data is now in the addressed location. Successive memory locations can 
be loaded as follows. 

k. Set the P/P+l switch to P+l. 

1. Repeat steps h through j for each successive memory location to be loaded. 

SINGLE INSTRUCTION OPERATION 

A program is executed in the single -instruction mode as follows. 

a. Set MA/SI/RUN switch to SI. (When the switch is not in the MA position, the 
FETCH/STORE and P/P+l switches are disabled.) 

b. Depress MASTER CLEAR pushbutton. 

c. Enter initial parameters into Register A, B, or P/Y as required. (Refer to the 
procedure for Register Load described in this section.) 

d. Depress START pushbutton. 

The first instruction is fetched from memory and placed in Register M and may be examined 
by depressing the Register-M pushbutton. Thereafter, each time the START pushbutton is 
depressed, the previously fetched instruction is executed, the next instruction is fetched, 
and the computer halts. If the P/Y pushbutton is depressed, the address from which the 
new instruction was fetched is displayed on the pushbutton /indicators (1 through 16). 
During execution (run operation) the SI position may be used at any time to aid in program 
debugging. 

RUN OPERATION 

A program is executed in the run mode as follows. 

a. Set MA/SI/RUN switch to RUN. 

b. Depress MASTER CLEAR pushbutton. 
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c. Enter initial parameters into Register A, B, or P/Y as required. (Refer to the 
procedure for Register Load described in this section.) 

d. Depress START pushbutton. 

The program will run until a HALT is executed or until the MA/SI/RUN switch is set to SI. 



KEY- IN LOADER 

The octal instructions listed below normally occupy memory locations 1 through 
2 7 g and enables the loading of "self- loading" paper tapes via the teletype or high-speed 
paper tape reader. 



Octal 
Address 

1 
2 
3 

4 

5 

6 

7 
10 
11 
12 
13 
14 
1 5 
16 
17 



Octal 
Instruction 

010057 

03000X 

13100X 

002003 

101040 

002003 

010000 

13100X 

002010 

041470 

13000X 

002013 

110000 

024000 

100040 



Meanin 



£ 



STA »57 
OCP '000X 
INA 4 00X 
JMP *-l 
SNZ 

JMP *-3 
STA 
INA '100$ 
JMP *-l 
LGL 8 
INA ►OOOX 
JMP *-l 
STA *0 
IRS 
SZE 



The value of "X n in the above instructions is dependent upon the input device used to read 
the paper tape. A "1" specifies the high-speed paper tape reader and a "4" specifies the 
teletype. 

The hardware protects memory locations l g through 1 7 g from modification by a 
stored program. Therefore, under normal conditions, the key-in loader should remain 
intact in these locations. However, when operating in the MA mode, locations 1 through 
17 g are unprotected, therefore care must be exerted to avoid inadvertently destroying the 
key-in loader while loading memory. The key-in loader is entered into memory as 
follows. 



a. 
to zero. 

b. 

c. 
d. 



Depress MSTR CLEAR pushbutton. The program counter (Register P) is set 

Set MA/ SI/ RUN switch to MA. This unlocks the protected area, addresses 1-17 . 
Set STORE/FETCH switch to store. 8 

Set P/P+ 1 switch to P+l. 
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e. Enter the first instruction (010057 g ) into Register M. 

f. Depress START pushbutton. Register P will be incremented by one, and the 
first instruction will be entered into location 000001 g. 

g. Repeat steps f. and g. for each of the remaining instructions to be loaded. 
Each time the START pushbutton is depressed, Register P will be incremented by one, 
and the instruction in Register M will be loaded into memory. 

Checking the Key-In Loader 

The following instructions are performed to ensure that the key-in loader has been 
loaded correctly into the designated memory locations. 

a. Depress MSTR CLEAR pushbutton. 

b. Set MA/SI/RUN switch to MA. 

c. Set STORE/FETCH switch to FETCH. 

d. Set P/P+l switch to P+l. 

e. Depress Register-M pushbutton. 

f. Depress START pushbutton. Register P will be incremented by one and the 
contents of memory location 00000 l g (010057) will be displayed on the pushbutton/ 
indicators (1 through 16). 

g. Repeat step f. for each of the remaining memory locations to be monitored. 
Each time the START pushbutton is depressed, Register P will be incremented by one and 
the contents of the addressed memory will be displayed. 
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section in 

SOFTWARE PACKAGE 



This section presents tables that list all routines in the DDP-516 software package, 
their document number, the format, and equipment required for each routine. Utility 
routines are given inTable 3-1, Input/Output routines are given in Table 3-2, and 
Mathematical routines are given in Table 3-3. 

Table 3-1. 
Utility Routines 



Type and Function 



Assemble DAP-coded 
source program 

Chain or segment 

program 

Check: 

Error entry or halt 

Overflow (and set 
error flag) 

Pseudo sense lights 
on /off 

Pseudo sense lights 

Sense switches 

Compile FORTRAN- 
coded source program 

Convert indirect address 
to direct address 

Debug (search, modify, 
clear memory, enter 
breakpoints) 

DAP/FORTRAN loaders 

Expanded loaders: 

ASR input (paper 
tape) 

Paper tape reader 
input 



Mnemonic 



DAP- 16 
CHAIN 

F$ER, F$HT 
OVERFL, 

SLITE 

SLITET 

SSWTCH 

FRTN 

ARG$ 

COP 



LDR-A 



LDR-P 



Doc. No. 



180275000 
180070000 



182602000 
182600000 



182599000 

180463000 
180072000 
188807000 



180335000 



180336000 



Format* 



DAP self- 
loading 
& object 

DAP self- 
loading 
& object 



Equipments- 
Required 



8K memory 
minimum 



Paper Tape 
Reader 



♦ All routines are in DAP object format unless otherwise specified. 
** "Equipment Required" is basic (ASR-33 or ASR-35 I/O) unless otherwise 



specified. 
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Table 3-1. (Cont) 
Utility Routines 



Type and Function 


Mnemonic 


Doc. No. 


Format* 


Equipment 5 '-'' 
Required 


Standard loaders: 










ASR input (paper tape) 


SLDR-A 


180341000 


DAP self- 
loading 




Paper tape reader 
input 


SLDR-P 


18034Z000 


DAP self- 
loading 


Paper tape 
Reader 


Dump: 










ASR Typewriter 
(various formats) 


DUMP 


188806000 






Logic: 










Logical complement 


N$33 


180090000 






Logical OR 


L$33 


180065000 






Object program punch 
and load 


PAL-AP 


180311000 






Transfer arguments from 
calling to called routine 


F$AT 


180071000 






Update: 










Symbolic source 
update 

Symbolic source 
update, I/O 
supervisor 


SSUP 
SSUP-IOS 


180767000 
180000000 




1 Paper tape 
[ Reader 
[ and Punch, 
l Magnetic 


Symbolic source 
update, revised 
dummy selection 


SSUP-RDS 


180304000 




) Tape 

Transport 



* All routines are in DAP format unless otherwise specified. 

** "Equipment Required" is basic (ASR-33 or ASR-35 I/O) unless otherwise 
specified. 
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Table 3-2. 
Input /Output Routine s* 



Type and Function 



FORTRAN IV Drivers: 
ASR Typewriter - 

Input 

Output 
Paper Tape Reader 
Paper Tape Punch 
Card Reader 
Magnetic Tape Transport 

Input 

Output 

Write File Mark 

Rewind 

Back space 
Device n 

Input 

Output 
FORTRAN IV: 

Format Control 
Argument Transfer 
Buffer Closeout 
I/O Supervisors: 
DAP ASR 

DAP Expanded I/O 
FORTRAN IV 
Standard Library. 
ASR Typewriter - 

Type a line 

Carriage return 

Advance to next line 

Initialize heading 

Initialize listing 
ASR Paper Tape Reader - 

ASCII 

Binary 
ASR Paper Tape Punch - 

ASCII 

Binary 

Leader 



Mnemonic 



F$R1 
F$W1 
F$R2 
F$W2 
F$R3 

F$R5-9 
F$W5-9 
F$D5-9 
F$B5-9 
F$F5-9 

F$RN 
F$WN 

F$IO 

F$AR 

F$CB 

IOS-16A 
IOS-16B 

F4-IOS 



0$AP 
0$AC 
0$AF 
0$HH 
0$LL 

I$AA 
I$AB 

0$AA 
0$AB 
0$AL 



Doc. No. 



182610000 
182611000 
182612000 
182613000 
182614000 

180306000 
180307000 
180308000 
180309000 
180310000 

180088000 
180089000 



182618000 



180323000 
180324000 
180016000 



180255000 
180774000 

189001000 
189002000 

189003000 
189004000 
189005000 



* All routines are in DAP object format. 
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Table 3-2. (Cont) 
Input/Output Routines* 



Type and Function 



High-Speed Paper Tape Reader- 
ASCII 
Binary 
High-Speed Paper Tape Punch - 
ASCII 
Binary 
Listing 
Heading 
Leader 

Punch one line 
Punch carriage return 
Advance to next line 
Card Reader 
ASCII 
Binary 
Magnetic Tape 
Input - 
BCD 
Binary 

Binary (3 characters/word) 
Output - 
BCD 
Binary 

Binary (3 characters /word) 
File mark 
Backspace 
One file - 
One record 
Rewind 
Forwardspace - 
One file 
One record 
Conversion - 

ASCII code to IBM tape code 
IBM tape code to ASCII code 
Translate transport numbers 



Mnemonic 



I$PA 
I$PB 

0$PA 
0$PB 
0$PL 
0$PH 
0$PLDR 

o$pp 

0$PC 
0$PF 

I$CA 
I$CB 



I$MA 
I$MB 
I$MC 

0$MA 
0$MB 
0$MC 
0$ME 

C$BF 
C$BR 
C$MR 

C$FF 
C$FR 

C$8T06 
C$6T08 
M$UNIT 



Doc. N< 



189006000 
189007000 

189008000 
189009000 

181479000 
189008000 

180257000 



1801 10000 
180609000 



182604000 



182605000 



182606000 



180082000 
180091000 
180228000 



* All routines are in DAP object format. 
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Table 3-3. 
Mathematical Routines 



Type and Function 


Mnemonic 


Doc. No. 


Format 


Complex: 








Absolute value 


CABS 


182596000 


FTRN object 


Add 


A$55 


182544000 


FTRN object 


Add single-precision argument 


A$52 


180041000 


FTRN object 


Conjugate 


CONJG 


182593000 


FTRN object 


Convert imaginary part to real 


AIMAG 


182578000 


DAP object 


Cosine 


CCOS 


180066000 


FTRN object 


Divide 


D$55 


180034000 


FTRN object 


Divide by single-precision 


D$52 


180044000 


FTRN object 


argument 








Exponential, base e 


CEXP 


182593000 


FTRN object 


Load 


L$55 


182542000 


DAP object 


Logarithm, base e 


CLOG 


182591000 


FTRN object 


Multiply 


M$55 


182545000 


FTRN object 


Multiply by single- precision 


M$52 


1 80045000 


FTRN object 


argument 








Negate a complex quantity 


N$55 


180069000 


FTRN object 


Raise to integer power 


E$51 • 


182594000 


FTRN object 


Sine 


CSIN 


182595000 


FTRN object 


Square root 


CSQRT 


182592000 


FTRN object 


Store (hold) 


H$55 


182543000 


DAP object 


Subtract 


S$55 


180093000 


FTRN object 


Subtract single-precision 


S$52 


180042000 


FTRN object 


argument 








Double- Precision: 








Fixed- Point: 








Add 


DADD 


188812000 


DAP object 


Arctangent 


DATNX1 


188793000 


DAP object 


Arctangent* 


DATNX2 


188794000 


DAP object 


Cosine 


DCOSX1 


188792000 


DAP object 


Cosine* 


DCOSX2 


1.80762000 


DAP object 


Divide 


DDIV 


188808000 


DAP object 


Divide* 


DDIVH 


188809000 


DAP object 


Exponential, base e 


DEXEX1 


188799000 


DAP object 


Exponential, base e* 


DEXEX2 


188800000 


DAP object 


Exponential, base 2 


DEX2X1 


188797000 


DAP object 


Exponential, base 2* 


DEX2X2 


188798000 


DAP object 



* Operates with Multiply /Divide option only. 
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Table 3-3. (Cont) 
Mathematical Routines 



Type and Function 


Mnemonic 


Doc. No. 


Format 


Logarithm, base e 


DLGEX1 


188801000 


DAP object 


Logarithm, base e * 


DLGEX2 


188802000 


DAP object 


Logarithm, base 2 


DLG2X1 


188795000 


DAP object 


Logarithm, base 2* 


DLG2X2 


188796000 


DAP object 


Multiply- 


DMPY 


188808000 


DAP object 


Multiply ♦ 


DMPYH 


188809000 


DAP object 


Round up binary number 


RODD 


188804000 


DAP object 


Sine 


DSINX1 


188790000 


DAP object 


Sine* 


DSINX2 


188791000 


DAP object 


Square root 


DSQRX1 


188788000 


DAP object 


Square root * 


DSQRX2 


188789000 


DAP object 


Subtract 


DSUB 


188813000 


DAP object 


Two's complement 


TWOS 


188803000 


DAP object 


Floating-point: 








Absolute value 


DABS 


182587000 


FTRN object 


Add 


A$66 


182540000 


DAP object 


Add single-precision argument 


A$62 


180037000 


FTRN object 


Add integer to exponent 


A$81 


180064000 


DAP object 


Arctangent, principle value 


DA TAN 


182584000 


FTRN object 


Arctangent, x/y 


DATAN2 


180056000 


FTRN object 


Clear (zero) exponent 


Z$80 


180060000 


DAP object 


Convert exponent to integer 


C$81 


180046000 


DAP object 


Convert to integer 


C$61 


182554000 


DAP object 


Convert to single- precision 
(from pseudo accumulator) 


C$62 


182576000 


DAP object 


Cosine 


DC OS 


1 89955999 


FTRN object 


Divide 


D$66 


1 82541000 


DAP object 


Divide by single-precision 

argument 


D$62 


180040000 


FTRN object 


Exponential, base e 


DEXP 


182581000 


FTRN object 


Load 


L$66 


182538000 


DAP object 


Logarithm, base e 


DLOG 


182579000 


FTRN object 


Logarithm, base 2 


DLOG2 


182579000 


FTRN object 


Logarithm, base 10 


DLOG10 


180051000 


FTRN object 


Maximum value 


DMAX1 


182585000 


DAP object 


Minimum value 


DMIN1 


182586000 


DAP object 


Multiply 


M$66 


1 82541000 


DAP object 


* Operates with Multiply /Divid 


3 option only. 
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Table 3-3. (Cont) 
Mathematical Routines 



Type and Function 


Mnemonic 


Doc. No. 


Format 


Multiply by single- precision 


M$62 


180039000 


FTRN object 


argument 








Negate 


N$66 


180061000 


DAP object 


Raise to double-precision 


E$66 


180054000 


FTRN object 


power 








Raise to integer power 


E$61 


180052000 


FTRN object 


Raise to single-precision 


E$62 


180053000 


FTRN object 


power 








Remainder 


DMOD 


182588000 


FTRN object 


Sine 


DSIN 


182583000 


FTRN object 


Square root 


DSQRT 


182580000 


FTRN object 


Store (hold) 


H$66 


182539000 


DAP object 


Subtract 


S$66 


182540000 


DAP object 


Subtract single-precision 


S$62 


1800380Q0 


FTRN object 


argument 








Transfer sign of second 


DSIGN 


182589000 


FTRN object 


argument to first 








Truncate fractional bits 


DINT 


180049000 


DAP object 


Integer: 








Absolute value 


IABS 


182552000 


DAP object 


Convert to double-precision 


C$16 


180059000 


FTRN object 


Convert (FORTRAN-generated) 


FLOAT 


180062000 


DAP object 


to single precision 








Convert to single precision 


C$12 


182575000 


DAP object 


Divide 


D$ll 


182546000 


DAP object 


Maximum single-precision 


AMAXO 


182548000 


DAP object 


value 








Maximum value 


MAXO 


182548000 


DAP object 


Multiply 


M$ll 


180035000 


DAP object 


Positive difference 


IDIM 


182556000 


DAP object 


Raise to integer power 


E$ll 


182547000 


DAP object 


Remainder 


MOD 


182555000 


DAP object 


Transfer sign of second 


ISIGN 


182557000 


DAP object 


argument to first 








Single- precis ion: 








Fixed-point: 








Arctangent 


ATNX1 


188779000 


DAP object 


Arctangent* 


ATNX2 


188780000 


DAP object 


Cosine 


COSX1 


188781000 


DAP object 


Cosine* 


COSX2 


180761000 


DAP object 



Operates with Multiply /Divide option only. 
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Tabic 3-3. (Cont) 
Mathematical Routines 



Type and Function 


Mnemonic 


Doc. No. 


Format 


Divide 


DiV 


188810000 


DAP object 


Exponential, base e 


EXEX1 


188786000 


DAP object 


E xp one nt ia 1 , base e * 


EXEX2 


188787000 


DAP object 


Exponential, base 2* 


EX2X1 


188782000 


DAP object 


Exponential, base 2 * 


EX2X2 


188783000 


DAP object 


Logarithm, base e 


LGEX1 


188814000 


DAP object 


I/O ga r ithm , base e * 


LGEX2 


188815000 


DAP object 


Logarithm, base 2 


LG2X1 


188784000 


DAP object 


L o ga r ithm , base 2 * 


LG2X2 


188785000 


DAP object 


Multiply 


MPY 


188811000 


DAP object 


R ound u p b i na r y numb e r 


ROND 


188805000 


DAP object 


Sine 


SINX1 


188777000 


DAP object 


Sine * 


SINX2 


188778000 


DAP object 


Square root 


SQRX1 


188775000 


DAP object 


Square root* 


SQRX2 


188776000 


DAP object 


Floating- point: 








Absolute value 


ABS 


182570000 


DAP object 


Add 


A$22 


182536000 


DAP object 


Arctangent, principle value 


A TAN 


182564000 


DAP object 


Arctangent, y/x 


ANTAN2 


182564000 


DAP object 


Convert (FOR TRAN-generated 
to double precision 


DBLE 


180058000 


DAP object 


Convert to integer or truncate 
fractional bits and convert 
to integer 


IF IX 


182553000 


DAP object 


Convert pair to complex 


CMPLX 


182597000 


FTRN object 


Convert to complex format 


C$25 


180068000 


FTRN object 


Convert to double- precision 


C$26 


182590000 


DAP object 


Convert to integer 


C$21 


182558000 


DAP object 


Divide 


D$22 


182537000 


DAP object 


Exponential, base e 


EXP 


182561000 


DAP object 


Hyperbolic tangent 


TANH 


182565000 


DAP object 


Load 


L$22 


182534000 


DAP object 


Logarithm, base e 


A LOG 


182559000 


DAP object 


Logarithm, base 10 


ALOG10 


182559000 


DAP object 


Ma x i m u m i n t e g e r v a 1 u e 


MAX1 


182549000 


DAP object 


M a x i m u m va 1 u e 


AMAX1 


182549000 


DAP object 


Minimum integer value 


MINI 


182551000 


DAP object 


Minimum value 


A MINI 


182551000 


DAP object 



* Operates with Multiply /Divide option only. 



Table 3-3; (Cont) 
Mathematical Routines 



Type and Function 


Mnemonic 


Doc. No. 


Format 


Multiply 


M$22 


182537000 


DAP object 


Positive difference 


DIM 


182573000 


DAP object 


Raise to double-precision 


E$26 


182582000 


FTRN object 


power 








Raise to integer power 


E$21 


182562000 


DAP object 


Raise to single-precision 


E$22 


180045000 


DAP object 


power 








Remainder 


AMOD 


182572000 


DAP object 


Sine 


SIN 


182563000 


DAP object 


Square root 


SQRT 


182560000 


DAP object 


Store (hold) 


H$22 


182535000 


DAP object 


Subtract 


S$22 


182536000 


DAP object 


Transfer sign of second 


SIGN 


182574000 


DAP object 


argument to first 








Truncate fractional bits 


A INT 


182571000 


DAP object 


Two's complement 


N$22 


180097000 


DAP object 
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SECTION IV 
GENERATION OF SELF-LOADING SYSTEM TAPES 

The DDP-5 16 Software package contains, in addition to an extensive library of 
object tapes, a few tapes that are self-loading. The self-loading tapes are the loader 
(LDR or SLDR) and the punch and load (PAL-AP) programs. (PAL-AP is also supplied in 
relocatable object form. ) These two programs enable you to generate self-loading system 
tapes tailored to your installation. (A DAP or FORTRAN system with less than 8K of 
memory cannot generate system tapes. ) This section contains detailed procedures for gen- 
erating self-loading system tapes for the DAP- 16 Assembler, the FORTRAN IV (FRTN) 
Compiler and the Symbolic Source Update (SSUP) Program. 

As illustrated in Figure 4-1, the procedure for generating a self-loading system 
tape (SLST) involves six operations. These operations are as follows. 

a. Entering the loader (LPR or SLDR) into high sectors of memory. 

b. Loading the main program (DAP- 16, FRTN or SSUP) into memory with 
specified starting locations at which loading and cross-sector linkage are to begin. 

c. Loading the I/O routines (IOS, I/O Library, etc. ) to satisfy the main program 

calls. 

d. Obtaining a memory map to determine the area of memory which contains data 

to be punched out on the system tape. 

e. Loading the punch and load program (PAL-AP) into the high sector of memory 
with the contents of a specified area of memory assigned to be punched out. 

f. Punching out the SLST. 

The procedural steps that follow have been abbreviated so that the instruction "Load XXXXX g 
into Register _" implies the three step REGISTER LOAD procedure described in Section II. 
Therefore, it is recommended that you familiarize yourself with the control console before 
attempting to generate an SLST. 

GENERATING A SELF-LOADING DAP- 16 SYSTEM TAPE 

The DAP- 16 Manual (3C Doc. No. 130071629) and the DDP-5 16 Programmers 
Reference Manual (3C Doc. No. 130071585) contain a complete description of the DAP- 16 
symbolic assembly program and the instructions for preparing programs in DAP- 16 source 
language. The following paper tapes from your library are required to generate a self- 
loading DAP- 16 system tape. 

a. Some version of SLPR or LDR as determined from Table 4-1 

b. PAL-AP (self-loading form) 

c. DAP- 16 (also contains IOS and MGTD) 

d. I/O Library 

e. DECCL and SETSIZ. 
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r ■ igure 4-1. Self Loading System Tape Generation 

Table 4-1. 
Loader Selection 



Device 


Loader 


Teletype: 




Standard Loader 


SLDR-A 


Expanded Loader 


LDR-A 


High Speed Paper Tape Reader: 




Standard Loader 


SLDR-P 


Expanded Loader 


LDR-P 



As indicated in Table 4-1, the peripheral devices at your installation determine which loader 
1 -> required to generate the SLST. In addition, the number of passes desired during an as- 
sembly and the options available at your installation effect the choice of loader. The standard 
loaders do not allow a one pass assembly and will not function with systems using the ex- 
tended addressing or memory lockout options. When you have determined which loader is 
required, proceed as directed in the following paragraphs. 



Load the Self- Loading Loader 

a. Check the key-in loader as described in Section II to ensure that it is intact. 

the loader has been disturbed, you must reload it. 
■ : ->. Depress the MSTR CLEAR pushbutton. 



c. Load 00000 1 into Register P. 

o ............... 

d. Insert the loader tape into the appropriate input device. 

e. Set the MA/SI/RUN switch to RUN. 

f. Depress the START pushbutton. (If you are loading from an ASR-33 teletype unit, 
the manual START switch on the device must be activated. If you are loading from an 
ASR-35 teletype unit, the MODE switch must be set-to KT. ) The loader program will be 
loaded into the high-order sectors of memory (the four high-order sectors for LDR or the 
three high-order sectors for SLDR), and the computer will halt. 



Load the DAP- 16 Object Tape 

a. Depress the MSTR CLEAR pushbutton. 

b. Load XX000, the starting location of the loader, into Register P (XX is the highest 
sector of memory). 

c. Insert the DAP- 16 object tape into the appropriate input device, 

d. Depress the START pushbutton. The tape will be loaded into memory starting at 
location 400 R . Loading will halt before the entire tape is read and the teletype will produce 
MR to indicate that additional routines must be loaded. 

e. Insert the I/O Library tape into the appropriate input device. 

f. Depress the START pushbutton. The teletype will again produce MR. 

g. Insert the tape containing DECCL and SETSIZ into the appropriate input device. 
h. Depress the START pushbutton. The teletype will produce LC to indicate that 

loading is complete. 

i. Load XX002 o into Register P to obtain a memory map. 
o 

j. Depress the START pushbutton. A memory map, having the format shown in 
Table 4-2, will be produced on the teletype. 

Table 4-2 
Memory Map 



* START 


D D D D D 


The entry location of the main program. 


* HIGH 


D D D D D 


The first location not used by the main program. 


* BASE 


D D D D D 


The first location not used in the base sector. 


* NAMES 


D D D D D 


The lowest location used by the loader. 


SUBI 


D D D D D 


The entry location of a subroutine. . 


LC 


• 


Loading complete 
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Punch the DAP System Tape 

a. Depress the MSTR CLEAR pushbutton. 

b. Load 00000 l g into Register P. 

c. Insert the PAL-AP tape into the appropriate input device. 

d. Depress the START pushbutton. The tape will be loaded into the highest 1200 
locations of memory. 

e. Load XX100 g into Register P. 

f. Load 100 ft into Register A. (If a teletype is being used, modify the Register -A 
load by setting bit 1 of the register. Depress the ON switch on the ASR-3 3 teletype punch 
or set the MODE switch to KT on the ASR-35 teletype unit. ) 

g. Depress the START pushbutton. The program will halt immediately, 
h. Load into Register A location HIGH obtained from the memory map. 

i. Depress the START pushbutton. The self-loading DAP- 16 system tape will be 
punched out by the appropriate output device. To test your system tape, perform an 
assembly as described in Section V. 

Computing DAP- 16 Memory-Table Size 

Each DAP- 16 literal-, symbol-, and transfer-vector-table entry occupies three words 
in memory. To calculate the total number of locations available in your computer, subtract 
the HIGH address obtained from your DAP- 16 memory map from the last address of your 
computer memory. Then subtract 100 ft from the remainder and divide the new remainder 
by 3. (All computations in octal. ) 

GENERATING A SELF-LOADING FORTRAN IV SYSTEM TAPE 

The FORTRAN IV Manual (3C Doc. No. 130071364) contains instructions for the 
preparation of FORTRAN IV programs to be used on your DDP-5 16 computer. To generate 
a self-loading FORTRAN IV system tape, you will need the following tapes from your library. 

a. Some form of SLDR or LDR as determined from Table 4- 1. 

b. PAL-AP (self-loading form) 

c. FRTN 

d. F4-IOS 

When you have determined which loader is required, proceed as follows. 

Load the FRTN Object Tape 

a. Perform the procedure for loading the self-loading loader as described earlier 
in this section. 

b. Depress the MSTR CLEAR pushbutton. 

c. Load XXOOOg, the starting location of the loader, into Register P (XX is the 
highest sector of memory). 
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d. Insert the FRTN object tape into the appropriate input device. 

e. Depress the START pushbutton. (If you are loading from an ASR-33 teletype unit 
the manual START switch on the device must be activated. If you are loading from an 
ASR-35 teletype unit, the MODE switch must be set to KT. ) When the tape has been read 
into memory, the teletype will produce MR to indicate additional routines must be loaded. 

Load the FRTN I/O Selector 

a. Insert the F4-IOS tape into the appropriate input device. 

b. Depress the START pushbutton. When the tape has been read into memory, the 
teletype will produce LC to indicate that loading is complete. 

c. Load XX002 8 into Register P to obtain a memory map. 

d. Depress the START pushbutton. A memory map, having the format shown in 
Table 4-2, will be produced on the teletype. 

Punch the FRTN System Tape 

a. Depress the MSTR CLEAR pushbutton. 

b. Load 00000 l g into Register P. 

c. Insert the PAL-AP tape into the appropriate input device. 

d. Depress the START pushbutton. The tape will be loaded into memory. 

e. Load XX100 g into Register P. 

f. Load 40 ft into Register A. If a teletype is being used, modify the Register-A 
load by setting bit 1 of the register. Depress the ON switch on the ASR-33 teletype punch 
or set the MODE switch to KT on the ASR-35 teletype unit. 

g. Depress the START pushbutton. The program will halt. 

h. Load into Register A location HIGH obtained from the memory map. 

i. Depress the START pushbutton. The self-loading FRTN system tape will be 
punched out by the appropriate output device. To test your system tape, perform the com- 
piling procedure described in Section V. 

GENERATE A SELF-LOADING UPDATE SYSTEM TAPE 

The following paper tapes from your library are required to generate a self-loading 
update system program. 

a. Some version of SLDR or LDR as determined from Table 4-1 

b. PAL-AP (self-loading form) 

c. SSUP 

d. SSUP-IOS 

e. SSUP-RDS 

f. I/O Library. 

When you have determined which loader is required, proceed as follows. 
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Load the SSUP Object Tape 

a. Perform the procedure for loading the self-loading loader as described earlier 
in this section. 

b. Depress the MSTR CLEAR, pushbutton. 

c. Load XXOOOg, the starting location of the loader, into Register P (XX is the 
highest sector of memory). 

d. Insert the SSUP object tape into the appropriate input device. 

e. Depress the START pushbutton. The tape will be read into memory starting at 
location 400^. When loading is complete, the teletype will produce MR to indicate that 
additional routines must be loaded. 

Load the IPS and the IPS Calls 

You must specify which I/P devices you wish to use when updating a symbolic source 
program. Pnly one device may be specified for each I/O form as indicated in Table 4-3. 
After you have determined which devices you wish to use, you must isolate the i/P routines 
required from the i/P Library tape by loading them individually using the appropriate input 
device. The procedure is as follows. 

a. Insert the SSUP-IPS tape into the appropriate input device. 

b. Depress the START pushbutton. When loading is complete, the teletype will 
produce MR. 

c. Insert the required I/P routines into the appropriate input device. 

d. Depress the START pushbutton. When loading is complete, the teletype will 
produce MR. 

e. Insert the SSUP-RDS tape into the appropriate input device. 

f. Depress the START pushbutton. When loading is complete, the teletype will 
produce LC. 

g. Load XX002 into Register P to obtain a memory map. 

8 

h. Depress the START pushbutton. A memory map will be produced on the tele- 
type having the format shown in Table 4-2. 

Punch the SSUP System Tape 

To punch out the SSUP system tape, perforin the procedure for punching a DAP System 
Tape as described earlier in this section. The SSUP system tape can be tested by perform- 
ing an update as described in Section V. 
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I/O Form 



Table 4-3. 
I/O Selection for SSUP 



Source Program to be 
Updated 



Source Program Con- 
taining Corrections 



Updated Source Program 



Listing of the Cor- 
rections 



I/O Device Desired* 



Magnetic Tape Unit 
High-Speed Paper Tape Reader 



ASR Paper Tape Reader 
High-Speed Paper Tape Reader 
Card Reader 



Magnetic Tape Unit 
High-Speed Paper Tape Punch 

ASR Paper Tape Punch 
ASR Listing 



I/O Routines Required 



I$MA, C$6T08, M$UNIT 
I$PA 



I$AA 
I$PA 
I$CA 



0$MA, C$8T06, M$UNIT 
0$PA 



0$AA 
0$LL 



*The update program requires a high-speed paper tape reader and punch or two 
magnetic tape units. 
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SECTION V 
OPERATING PROCEDURES 



This section presents detailed procedures for loading, executing, assembling and 
compiling programs, and generating self-loading paper tapes. The assembly, compilation, 
and updating procedures describe how to use the self-loading system tapes that you gen- 
erated in accordance with the instructions given in Section IV. Some of the procedures that 
you performed for specific programs in Section IV have been generalized to cover all pro- 
grams on paper tape. 

LOAD 

The following paragraphs contain procedures for loading both self-loading and 
object programs on paper tape. 

Load Self-Loading Programs 

a. Depress the MSTR CLEAR pushbutton. 

b. Load 00000 l g into Register P. 

c. Insert the self-loading tape into the appropriate input device. 

d. Depress the START pushbutton. (When lQading with an ASR-33 teletype unit, the 
manual START switch on the device must be activated. When loading with an ASR-35 tele- 
type unit, the MODE switch must be set to KT. ) (Observe Register X which should indicate 
counting if the tape is being loaded correctly. ) The program will be loaded into the loca- 
tions it occupied when it was punched out. Loading any self-loading tape destroys the con- 
tents of locations 00020 R through 00057 ft inclusive. 

Load Object Programs 

a. Perform the procedure for self-loading programs described above using the 
appropriate self-loading loader program. 

b. Load XX000 ft , the starting location of the loader, into Register P (XX is the high- 
est sector of memory). If the object program is relocatable (REL), perform steps c. and 
d. If the object program is absolute (ABS), skip steps c. and d. and continue at step e. ) 

c. Load Register A with the octal address of the location at which loading is to begin. 
Otherwise a starting location of 1000 ft will be assumed. To force a starting location of 
OOOOOg, load 100^000^ into Register A. (Locations 1 through 17 octal in memory are write 
protected and nothing will be loaded into this area. ) 
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d. Load Register B with the octal address of the location at which the inter-s 



e c t o r 



indirect address word table is to begin. Otherwise, a starting location of 100 u will be 

o 

assumed. 

NOTE 

The inter-sector indirect word table must be located in sector 
for DDP-5 16 computers without the Memory Lockout Option. The 
table may be in any sector for computers with the option. The 
sector may be changed at load time by the pseudo-operation SETB. 



e. Insert the object program into the appropriate input device. 

f. Depress the START pushbutton. The object program will be loaded into memory 
until a halt occurs and a loader message is produced on the teletype. Refer to Table 5-1 
for the significance of the loader messages. 

Table 5-1. 
Loader Messages 



Message 



LC 

MR 

CK 

BL 
MO 



Meaning 



Loading complete 

More subroutines 
required 

Checksum error in the 
last block read 

Block too large or 
improperly formatted 

Memory overflow due to 
program attempting to 
overwrite the loader 



Action Required 



Depress the START pushbutton to begin program 
execution 

Insert the required subroutine tapes into the 
appropriate input device and depress the START 
pushbutton to continue loading 

Depress the START pushbutton to ignore the 
block and continue loading. A valid load is not 
assured 

Depress the START pushbutton to ignore the 
block and continue loading. A valid load is not 
assured 

Depress the START pushbutton to obtain a 
memory map. Refer to Table 4-2 for the 
memory map format. No recovery is possible 
from this error. 



The loader cannot detect a program overlaying the indirect word tables or the tables over- 
laying the program. You must obtain a memory map to determine whether overlap exists. 
The loader will detect base sector overflow and produce an MO message. 

Options Following a Loader Halt 

When a loader halt occurs and a message is produced, there are several options you 
can perform other than those specified in Table 5-1. 
The options allow you to: 

a. Reload the object tape by repeating the procedure for load object programs 
described above. 

b. Recover from a missing end-of-tape block. The procedure is as follows. 

(1) Momentarily set the MS/SI/RUN switch to SI to stop the computer. 

(2) Load XX001 g into Register P. 

(3) Depress the START pushbutton. 
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c. Print a memory map. The procedure is as follows. 

(1) Load XX002 8 into Register P. 

(2) Depress the START pushbutton. A memory map will be produced on the 
teletype. See Table 4-2 for the format of the memory map. 

d. Set a program break. The procedure is as follows. 

(1) Load XX003 8 into Register P. 

(2) Load Register A with the address of the location at which loading is to con- 
tinue. If Register A is cleared, the origin for loading remains unchanged. 

(3) Depress the START pushbutton and loading will continue. 

e. Force-load a subprogram. The procedure is as follows. 

(1) Load XX004g into Register P. 

(2) Insert a tape into the appropriate input device if required. 

(3) Depress the START pushbutton. The tape will be loaded into memory. 

f. Begin executing the object program. The procedure is as follows. 

(1) Load XX005 g into Register P. 

(2) Depress the START pushbutton and the program will be executed. 

ASSEMBLE DAP- 16 SOURCE PROGRAMS 

This procedure enables you to perform an assembly by using your self-loading 
DAP- 16 system tape. To perform the assembly, proceed as follows. 

a. Depress the MSTR CLEAR pushbutton. 

b. Load 00000 1 Q into Register P. 

o 

c. Insert the DAP- 16 system tape into the appropriate input device. 

d. Depress the START pushbutton and the system tape will be loaded into memory. 
Monitor Register X for counting. 

e. Select a bit pattern from Table 5-2 to designate a one- or two-pass assembly 
and to designate the I/O devices to be used during the assembly. 

f. Load the selected bit pattern into Register A. 

g. Load 400 g into Register P. There are five standard starting options available 
for the DAP- 16 Assembler. 

(1) 400 o - Start assembly 

o 

(2) 401 ft - Continue assembly 

(3) 402 o - Start subroutine tape assembly 

o 

(4) 403 o - Terminate assembly 

o 

(5) 404 o - Restart pass two to produce additional object tapes. 

8 
h. Insert a DAP- 16 source tape into the appropriate input device and turn on your 

input /output equipment. 

NOTE 

If you are using the high-speed paper tape equipment or an 
ASR-35 to assemble, perform step i to complete the procedure. 
If you are using the ASR-33 to assemble, skip step i and per- 
form steps j through n. 
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Ill . 
n. 



i. Depress the START pushbutton and the assembly will be executed. 

j. Depress the START pushbutton. A portion of the source tape will be read and a 
halt will occur. 

k. Depress the ON pushbutton on the ASR-33 paper tape punch. 

1. Depress the START pushbutton. A length of object tape will be punched and a 
halt will occur. 

Depress the OFF pushbutton on the ASR-33 paper tape punch. 

Repeat steps j through m until the complete source tape has been read and a complete 
object tape has beenpunched. (If after a punch sequence the source tape is not read as in step j, 
repeat steps kthrough n. This occurs when there are two blocks to be punched. ) 

After the assembly is completed, you will have an object tape and a listing of yoL 
program if these were requested. When operating in the two-pass assembly mode, the 
output is generated during the second pass which is accomplished by repeating steps h. and 
i. after the source tape has been read the first time. If the assembly was successfully 
completed, Register A will contain all ONEs when the computer halts. If a MOR pseudo- 
operation was encountered, Register A will contain all ZEROs. 

The DAP- 16 assembler indicates coding errors by typing or printing error flags in 
the left-hand margin of the listing. (See Table 9-1. ) Such errors do not interfere with the 
assembly process. Undefined symbols are automatically defined by the Assembler and are 
listed at the end of the last-pass. 



)ur 
le 



Set Bit 



3 
4 
5 
6 



7 

8 

9 

10 

11 



12 
13 
14 
15 
16 



Table 5-2 
Assembly and I/O Device Selection 



Assembly or I/O Device Selected 



Two-pass assembly. If bit 1 is not set, 
a one pass assembly is executed. 

Input Device 

Teletype Unit 

High-Speed Paper Tape Reader 

Card Reader 

Magnetic Tape Unit 

Teletype Unit with halts for manual inputs 

Output Device 
Teletype Unit 

High-Speed Paper Tape Punch 
Card Punch 
Magnetic Tape Unit 
No Object Output 

Listing Device 
Teletype Unit 

High-Speed Paper Tape Punch 
Magnetic Tape Unit 
Line Printer 
No Listing 



NOTE 



If any of the five-bit I/O groups are all ZEROs, a standard 
device, depending on the configuration, will be selected. 
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b. 
c. 
d. 
e. 



COMPILE FORTRAN IV SOURCE PROGRAMS 

This procedure enables you to compile FORTRAN IV source tapes by using your 
self-loading FORTRAN IV system tape. The procedure is as follows, 
a. Depress the MSTR CLEAR pushbutton. 
Load 00000 l g into Register P. 

Insert the FORTRAN IV system tape into the appropriate input device. 
Depress the START pushbutton and the system tape will be loaded into memory. 
Select a bit pattern from Table 5-3 to designate the I/O devices to be used 
during the compilation. 

f. Load the selected bit pattern into Register A. 

g. Load lOOOg into Register P. 

h. Set the SENSE switches to desired positions. (See Table 5-4. ) 
i. Insert a FORTRAN IV source tape into the appropriate input device and turn on 
your input/ output equipment. 

j. Depress the START pushbutton and the compilation will be executed. 

When the compilation has been completed, the teletype will produce "End of Job". 
The selected devices will generate a listing and an object tape provided that these outputs 
have riot been suppressed. The FORTRAN IV compiler indicates coding errors, typing or 
printing errors by printing error flags on the listing following the FORTRAN statement con- 
taining the error. (See Table 9-2. ) Some errors are recoverable and do not interfere with 
the compilation. Others, however, halt the computer and must be corrected before con- 
tinuing. 

Table 5-3. 
I/O Device Selection 



Bit Selection 


I/O Device Selected 


Contents of bits 8-10 
1 
2 
3 

Contents of bits 11-13 

1 
2 

Contents of bits 14-16 

1 
2 


Input Device 
Teletype Unit 
Card Reader 
High-Speed Paper Tape Reader 

Listing Device 
Suppress Listing 
Teletype Unit 
Line Printer 

Output Device 
Suppress Output 
High-Speed Paper Tape Punch 
Teletype Unit 
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Sense Switch 



Table 5-4. 
Sense Switch Settings 



Significance 



Expand the symbolic listing to include side -by -side octal 
information 

Inhibit symbolic listing (not valid if Sense Switch 1 is set) 

Halt before inputting next record. During the pause (A) 
will display the current status of the I/O keyboard. The 
status may be changed before resetting Sense Switch 3 
and depressing the START pushbutton 

Cause trace -coupling information to be included in the 
object coding being generated regardless of any trace 
statements in the program. (This is an operator 
override. ) 



DEBUG PROGRAMS 

Your software package includes a utility program called COP (Check-Out Program) 
which is designed to assist you in debugging programs. The COP program is relocatable 
and therefore can be loaded into memory so as not to interfere with the program being 
debugged. The following procedures describe loading and executing COP. 

Loading COP 

This procedure assumes that the object program to be debugged has been loaded into 
memory using the procedure for loading object programs which is described earlier in this 
section. 

a. Load XX002~ into Register P to obtain a memory map. 

b. Depress the START pushbutton. A memory map will be produced on the teletype. 
(See Table 4-2 for map format. ) 

c. Load the COP object program into memory by using the procedure for loading 
object programs which is described earlier in this section. (COP may utilize locations in 
sector zero for cross-sector linkage. Refer to the memory map before selecting the start- 
ing locations to be loaded into Registers A and B as part of the loading process. ) 

Execute COP 

When COP has been loaded into memory, there are a number of operations that you 
can perform with the teletype. These operations are explained in Table 5-5 where the 
first column designates the operation, the second column specifies the keys used on the 
teletype, and the third column explains the operation performed. 
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Table 5-5. 
COP Operations 



Operation 


Teletype Keys 
Activated* 


Explanation 


A 


A RETURN 
X, Y RETURN 


Type the octal contents of memory from location 
X to location Y. 


B 


B RETURN 
X, Y RETURN 
(.) 


Insert correction Y into location X. Type Y 
RETURN to insert second and successive cor- 
rections. A slash (/) will be printed out when 
the memory modification has been completed. 


C 


C RETURN 
X, Y RETURN 


Enter breakpoint at location X and start program 
at location Y. Location 5 1 1 of sector zero is 
used to RETURN from a breakpoint. 


D 


D RETURN 


RETURN to the breakpoint and continue the 
program being debugged. Clear breakpoint, 
only one breakpoint active at a time. 


E 


E RETURN 
X, Y RETURN 


Clear the contents of memory from location X 
to location Y. 


F 


F RETURN 
X, Y RETURN 
Z RETURN 


Search memory between locations X and Y for 
address Z. 


Gl 


Gl, A, B, X, C RETURN 
X, Y RETURN 


Start at location X and print the contents of the 
specified registers every time control passes 
through location Y. 


G2 


G2, A, B, X, C RETURN 
X, Y RETURN 
N RETURN 


Start at location X and print the contents of the 
specified registers every Nth time control 
passes through location Y. 


G3 


G3, A, B,X, C RETURN 
X, Y RETURN 
I RETURN 
N RETURN 


Start at location X and print the contents of the 
specified registers the first I times of every 
N times control passes through location Y. 


G4 


G4, A, B, X, C, RETURN 
X, Y RETURN 
N RETURN 


Start at location X and print the contents of the 
specified registers for the first N times 
control passes through location Y. 


G5 


G5, A, B, X, C, RETURN 
X, Y RETURN 


Start at location X and print the contents of the 
specified registers every time control passes 
through location Y. 


G6 


G6, A, B, X, C RETURN 
X, Y RETURN 
A or B or M space > 
or = or < 
Space D RETURN 
Z RETURN 
(Z is entered only if 
a memory location M 
is to be tested. ) 


Start at location X and print the contents of the 
specified registers every time control passes 
through Y if the specified condition is true. 


G7 


G7, A, B, S, C, RETURN 
X RETURN 


Start at location X and print the contents of the 
specified registers (trace). 



*X, Y, and Z denote octal numbers. D, I, and N denote decimal numbers. In the G 
operations, A, B, X, and C denote registers. Any combination of these registers may 
be specified. The checkpoint and its contents are printed whether or not registers are 
specified. 
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UPDATE SOURCE PROGRAMS 

Ycur software package contains a symbolic source update program (SSUP) which will 
enable you to delete, correct, preserve or add records to a symbolic source program. 
The following procedures describe loading and executing SSUP. 

Load SSUP 

To load program SSUP, proceed as follows. 

a. Depress the MSTR CLEAR pushbutton. 

b. Load 000001 into Register P. 

c. Insert the SSUP system tape into the appropriate input device. 

d. Depress the START pushbutton and the system tape will be loaded into memory. 
Monitor Register X for counting. 

e. Insert the source tape to be updated into the appropriate input device. 

f. Set SENSE SWITCH 1 to the appropriate position. The up position (set) selects 
the FORTRAN IV updating option; the down position (reset) selects the DAP- 16 updating 
option. 



Execute SSUP 

When SSUP has been loaded into memory, there are a number. of operations you can 
perform using the teletype which allows you to modify the old source tape and punch a new 
source tape which reflects the modifications. These operations are explained in Table 5-6 
where the first column designates the operation command, the second column specifies the 
keys used on the teletype, and the third column explains the operation performed. Refer to 
the SSUP program listing (3C Doc. No. 180767000) for a complete description of the rules 
for using SSUP. 

Table 5-6. 
SSUP Operations 



Operation 
Command 



List 

No List 
Begin 

Halt 



Teletype Keys 

Activated \l/ 



$LIST (*F*L1*, *L2) 

$NLST 

$BEGN (*F*L1) 

$HALT 



Explanation 



Make a listing of the program including correc- 
tions as specified by L 1 and LZ. 

Do not make a listing 

Position the new source tape to the file or 
record specified by LI. 

Halt SSUP and print a breakpoint halt on the 
listing. 



\^1/ An asterisk (*) indicates permissible spaces and the entries within the paren- 
thesis indicate optional operations dependent upon the command. 
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Table 5-6. (Cont) 
SSUP Operations 



Operation 
Command 



Reset 

No Copy- 
Copy 

Done 
Insert 

Omit 

End of File 



Teletype Keys 

Activated \l/ 



$RSET (*F*L1) 

$NCPY 

$COPY (*F*L1*, *L2) 

$DONE 

$NSRT (*F*L1*, *L2) 

$OMIT (*F*L1*, *L2) 
$WEOF 



Explanation 



Set the internal file or record counter for the 
tape being updated to the value specified 
by LI. • 

Do not write onto the new source tape. 

Copy onto the new source tape that information 
specified by L 1 and L2. 

Terminate the updating process. 

Insert new information onto the new source tape 
which does not appear on the old source tape. 

Delete information that appears on the old 
source tape by not copying it onto the new 
source tape. 

Write an end of file mark on the output mag- 
netic tape. 



\l/ An asterisk (*) indicates permissible spaces and the entries within the paren- 
thesis indicate optional operations dependent upon the command. 



DUMP THE CONTENTS OF MEMORY 

Your software package contains a memory dump program which is appropriately 
called DUMP. The program enables you to print selected areas of memory on the teletype 
in any one of three formats. The procedure for using DUMP is as follows. 

a. Depress the MSTR CLEAR pushbutton. 

b. Load XX002 g into Register P and depress the START pushbutton to obtain a 
memory map. 

c. Load the DUMP program into memory by using the procedure for loading object 
programs that was described earlier in this section. 

d. Load into Register P the address at which the DUMP program begins. (This 
address is determined from the memory map and is loaded into Register A during the 
loading procedure performed in step c. ) 

e. Depress the START pushbutton. The program performs a carriage return, a 
line feed and awaits instructions via the teletype. 

f. Select the appropriate sense switch settings to obtain the desired dump format. 
The selections are as follows. 



Sense Switch Setting 

1 Set 

2 Set 

1 and 2 Reset 



Format Option 

Octal printout with eight columns per row. 
Mnemonic printout with four columns per row. 
Mnemonic printout with one column per row. 
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g. Specify the limits of the dump by typing in X CARRIAGE RETURN and Y 
CARRIAGE RETURN where X and Y are octal numbers specifying the lower and upper limits 
of the dump, respectively. The contents of the specified area of memory will then be 
printed by the teletype. If an error is made in the entry format, a slash (/) will be typed 
and the arguments must be entered correctly. 

PUNCH SELF-LOADING OBJECT TAPES 

A program is provided in your software package which enables you to punch self- 
loading object tapes of any segment of memory. This punch and load program (PAL-AP) is 
supplied in self-loading form. The following procedures describe the method for loading 
the program and executing the program once it is loaded. 

Load the Self -Loading PAL-AP 

a. Depress the MSTR CLEAR pushbutton. 

b. Load 00000 l g into Register P. 

c. Depress the START pushbutton. The tape will be loaded into the highest 1200 g 
locations of memory. (The program overlays the relocating loader if it is currently in the 
high sectors of memory and locations 00020 ft through 00057 R are destroyed.) 

Execute PAL-AP 

a. Depress the MSTR CLEAR pushbutton. 

b. Load ZZ100 into Register P. (ZZ is the sector into which PAL-AP was loaded. ) 

c. Load into Register A the starting address of the data to be punched out. (If the 
teletype is being used, set the high-order bit of Register A and turn on the punch unit on the 
teletype. ) 

d. Depress the START pushbutton. The program will halt at location ZZ117 R . 

e. Load into Register A the ending address of the data to be punched out. 

f. Depress the START pushbutton. A self-loading object tape will be punched out. 
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SECTION VI 
UTILITY LIBRARY 



This section contains short descriptions of the routines in the DDP-5 16 Utility Library. 
The purpose, storage requirements, and usage are given for each routine. Errors that 
may occur and other routines called are also given where applicable. In some cases more 
detailed information contained either in the program listing or other documents is referenced. 

DAP ASSEMBLER (DAP 16) 

Purpose 

The DAP assembler is designed to convert DAP source language programs to object 
form for execution on the DDP-116, 416, or 516. DAP- 16 is a one- or two-pass assembler. 
Additional passes may be made to produce extra copies of the program in object form. 

Storage Requirements 

DAP- 16 requires a minimum of 4K core storage using IOS-16A (preselected i/O), or 
8K using IOS-16B (selectable i/O). 

Usage 

Refer to the DAP- 16 Reference Manual, 3C Doc. No. 130071629, to the program 
listing, 3C Doc. No. 180275000, and to section V of the manual for complete details on 
use and operation. 

FORTRAN IV COMPILER (FRTN) 

Purpose 

The FORTRAN IV Compiler is designed to compile ASA standard FORTRAN IV 
programs in one pass and generate optimum object code for execution on the DDP-116, 
or 516. 

Storage Requirements 

FRTN requires a minimum of 8K storage. 
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Usage 

Refer to FORTRAN IV Manual, 3C Doc. No. 130071479 and section V of this manual 
for complete details on usage. 

PUNCH AND LOAD (PAL-AP) 

Purpose 

PAL-AP is used to punch self-loading object tapes for execution on the DDP-516. 
PAL-AP consists of a punch section and a load section. The load section is of the boot- 
strap variety. PAL-AP will first punch out its own loader section in 8-8 format followed 
by 12 in. of leader. The desired program is then punched in PAL format, which is 
recognized by the loader. The self-loading ability of a PAL program may thus be seen. 
The loader on the front of the tape will load itself and then the PAL-format program. 

Storage Req uirements 

PAL-AP requires less than one sector of memory. 

Usa ge 

Refer to Section V of this manual for complete procedures for using PAL-AP and 
to 3C Doc. No. 180311000 for a program listing. 

EXPANDED LOADER (LDR-A) 

Purpose 

LDR.-A loads absolute and relocatable main programs and subprograms produced 
by the DAP- 16 Assembler (in a one or two-pass mode) or the FORTRAN IV Compiler into 
the DDP-516 memory. LDR-A loads paper tape through the ASR teletypewriter. 

Storag e Requirements 

LDR-A requires approximately 3 1/2 sectors of memory. 

Usage 

Refer to program listing, 3C Doc. No. 180335000, and to Section V of this manual 
for complete details on usage. 
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EXPANDED LOADER (LDR-P) 

Purpose 

LDR-P loads absolute and relocatable main programs and subprograms produced 
by the DAP-16 Assembler (in a one or two-pass mode) or the FORTRAN IV Compiler into 
the DDP-516 memory. LDR-P loads tape through the high-speed paper tape reader. 

Storage Requirements 

LDR-P requires approximately 3 1/2 sectors of memory. 

Usage 

Refer to program listing, 3C Doc. No. 180336000, and to Section V of this manual 
for complete details on usage. 

STANDARD LOADER (SLDR-A) 

Purpose 

SLDR-A loads absolute and relocatable main programs and subprograms produced by 
the DAP-16 Assembler (two-pass mode only) or the FORTRAN IV Compiler into the 
DDP-516 memory. SLDR-A loads paper tape through the ASR tape reader. SLDR-A may 
not be used with Extended Addressing and Memory Lockout options. 

Storage Requirements 

SLDR-A requires more than two sectors of memory. 

Usage 



Refer to program listing, 3C Doc. No. 180341000, and to Section V of this manual 
for complete details on usage. 

STANDARD LOADER (SLDR-P) 

Purpose 

SLDR-P loads absolute and relocatable main programs and subprograms produced 
by the DAP-16 Assembler (two-pass mode only) or the FORTRAN IV Compiler into the 
DDP-516 memory. SLDR-P loads paper tape through the high-speed paper tape reader. 
SLDR-P may not be used with Extended Addressing and Memory Lockout options. 

Storage Requirements 

SLDR-P requires more than two sectors of memory 
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Usage 

Refer to program listing, 3C Doc. No. 18034Z000, and to Section V of this manual 
for complete details on usage. 

MEMORY DUMP - OUTPUT ON ASR-33 (DUMP) 

Purpose 

Print out selected areas of core on the ASR-33 typewriter with three different 
format options as follows: 

a. If sense switch 1 is set, memory is printed octally between specified limits 
with eight columns per row. 

b. If sense switch 2 is set, memory is printed in mnemonic format between 
specified limits with four columns per row. 

c. If sense switches 1 and 2 are reset, memory is printed in mnemonic format 
between specified limits with one column per row. 

Storage Req uirements 

DUMP requires one sector of memory. 

Usage 

Refer to the program listing, 3C Doc. No. 188806000, and to Section V of this 
manual for complete operating procedures. 

Errors 

Arguments entered incorrectly. A slash will be typed and the user must re-enter 
the arguments correctly. 

CHECK-OUT PROGRAM (COP) 

Purpose 

COP aids in check-out and debugging of DDP-516 programs by permitting the user 
to print out selected areas of core (trace option), delete or insert single words or blocks of 
words, enter breakpoints, initiate jumps or jumps and halts, and search all or any part 
of memory for references to specific addresses. 

Storage Requirements 

COP requires 628 in (ll64 ) locations (Rev. A). 
1 U o 
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Usage 

Refer to program listing, 3C Doc. No. 188807000, and to Section V of this manual 
for complete details on options available and their use. 

Errors 

Incorrect format for calling an option. A slash will be typed and the user must 
re-enter the call for the option correctly. 

SYMBOLIC SOURCE UPDATE PROGRAM (SSUP) 

Purpose 

SSUP reads symbolic records that are less than 80 characters long and permits a user 
to delete, correct, preserve, or add records to the symbolic source to create a new revised 
symbolic source. SSUP is compatible with any peripheral device that can be controlled by 
IOS, and will operate on any DDP-516 having either the high-speed paper-tape reader and 
punch option or two magnetic tape units. 

Storage Requirements 

SSUP requires 1055 (2037 g ) locations (Rev. B). 

Usage 

Refer to program listing, 3C Doc. No. 180767000, and to Section V of this manual for 
a complete description of the use of commands, the procedure for making corrections, and 

error messages. 

Errors 

For complete details of invalid commands or incorrect limits, refer to the program 
listing; 

Other Routines Called 
SSUP-IOS 



SYMBOLIC SOURCE UPDATE, INPUT/OUTPUT SUPERVISOR (SSUP-IOS) 

Purpose 

SSUP-IOS selects the proper input/output device required by SSUP, and causes it to 
input to or output from buffer areas provided by SSUP. SSUP never calls an input/output 
routine directly, but rather calls on SSUP-IOS when it is required to input the updating 
master or old master, or output the new master, the print master, or comments. SSUP 
also calls on SSUP-IOS for initialization of a heading line and when an end-of-job or an 
end-of-file condition is encountered. 



6-5 



Storage Requirements 

SSUP-IOS requires 161 1() (241 8 ) locations (Rev. A). 

Usage 



Refer to the program listing, 3C Doc. No. 180000000, for complete details on 
usage and method. ' 

Other Routines Called 



0$LH, I$AA, 0$ME, I$MA, C$T06, 0$LA, 

0$AH, I$PA, 0$PS, I$PA, 0$MA, 0$LL, 

I$CA, 0$AL, 0$AS C$T08, 0$PA 

SYMBOLIC SOURCE UPDATE - REVISED DUMMY SELECTION (SSUP-RDS) 

Purpose 

SSUP-RDS satisfies IOS calls for input/output routines that have not been loaded. 
This subroutine is loaded after all input/output routines. Its prime use is in the preparation 
of, an SSUP systems tape. The subroutine is entered at execution time only when a non- 
selected I/O subroutine is called by IOS. It automatically steps through the calling 
sequence, and then returns directly to the IOS to call on the next I/O subroutine on the list. 

Storage Requirements 

SSUP-RDS requires 25 1() (31 8 ) locations (Rev. A). 

Method 

Refer to program listing, 3C Doc. No. 180304000, for details on the method used. 

CHAIN OR SEGMENT (CHAIN) 

Purpose 

CHAIN is used to read in the next segment of a "chained" program. The chain 
segment is assumed to be written in load-mode on paper tape, to be read by the paper tape 
reader, and to start at location 1000 8 . The size of memory is determined and the modified 
load mode program is transferred to the end of memory. The segment from the paper tape 

reader is then loaded in and control is transferred to 1000 . 

8 

Storage Requirements 

CHAIN requires 67 1() O02 8 ) locations (Rev. A). 
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Usage 

The calling sequence for this routine is as follows. 
CALL CHAIN 

INDIRECT TO DIRECT ADDRESS (ARG$) 

Purpose 

ARG$ provides a software representation of indirect addressing by converting the 
indirect address of an argument to its corresponding direct address and storing it in the 
index register. 

Storage Requirements 

ARG$ requires 15, (17 ) locations (Rev. A). 

Usage 



The calling sequence for this routine is as follows. 

CALL ARG$ 

DAC* (argument address) 

ARGUMENT TRANSFER (F$AT) 

Purpose 

F$AT transfers a variable number of arguments from the calling routine to the 
called routine. The number of arguments are specified by the first pseudo-operation 
following the call. The second pseudo -operation specifies the beginning location of the 
block into which the arguments are to be placed. 

Storage Requirements 

F$AT requires 49 10 (6l g ) locations (Rev. A). 

Usage 

The calling sequence for this routine is as follows. 

(entry to routine) 
CALL F$AT 

DEC N (number of arguments to pass) 

DAC A (pointer to storage block for arguments) 
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ERROR ENTRY OR HALT (F$ER, F$HT) 

Purpose 

F$ER causes a mnemonic error indicator to be printed on the ASR-33 when an 
object time error is encountered in a specific routine. F$HT causes the computer to stop 
and print PA if a PAUSE statement has been encountered, or to print ST if a STOP state- 
ment has been encountered. 

Storage Requirements 

F$ER and F$HT require 36 10 (44 g ) locations (Rev. A). 

Usage 

The calling sequence for F$ER is 

CALL F$ER 
DAC ARG1 



where ARG1 is the address of the indicator to be printed out. The routine will print out 
the error indicator and then halt if SENSE SWITCH 3 is set. Depressing the START push- 
button after the halt will cause the program to continue. If SENSE SWITCH 3 is not set, 
F$ER will exit with no printout or halt taking place. 
The calling sequence for F$HT is as follows. 

CALL F$HT 
DAC = '151724 

This calling sequence is normally generated when the STOP statement has been 
encountered in the compilation process. The literal specified is the ASCII equivalent of 
ST which is the object time indicator specifying that a stop has been encountered. 

OVERFLOW - SET ERROR FLAG (OVERFL) 

Purpose 



OVERFL is used to check error conditions. The error flag is turned off. Indicator 
J is set to 1 if the error flag was on, or set to 2 if the error flag was off. The error flag 
is located in subroutine F$ER and is set anytime an error occurs in an arithmetic function 
calculation or in an input/output conversion. 

Storage Requirements 

OVERFL requires 14 10 (l6g) locations (Rev. A). 
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Usage 

The calling sequence for OVERFL is as follows. 

DAP FORTRAN 



CALL OVERFL 
DAC J 

(return) 



CALL OVERFL (J) 



PSEUDO SENSE LIGHTS (SLITE, SLITET, SSWTCH) 



Purpose 

SLITE (I) 
SLITET (I, J) - 

SSWTCH (I, J) - 



To set sense light I; or if 1=0, to reset all sense lights. 

To test sense light I and turn it off. 

If sense light I was set, indicator J is set to 1. 

If sense light I was reset, indicator J is set to 2. 

To test sense switch I and to set indicator J to 1 if I is 

set or to set indicator J to 2 if I is reset. 



Storage Requirements 

Routines SLITE, SLITET, and SSWTCH require 73 1() (111 8 ) locations (Rev. A). 



Usage 

The calling sequence for SLITE is as follows. 

DAP 

CALL SLITE 

DAC I (address of variable 

containing sense light number) 

The calling sequence for SLITET is as follows. 

DAP 

CALL SLITET 

DAC I (address of variable 

containing sense light number) 

DAC J (address for storing indicator) 

The calling sequence for SSWTCH is as follows. 

DAP 

CALL SSWTCH 

DAC I (address of variable 

containing sense switch to 
be interrogated) 

DAC J (address for storing indicator) 



FORTRAN 
CALL SLITE (I) 



FORTRAN 
CALL SLITET (I, J) 



FORTRAN 
CALL SSWTCH (I, J) 
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Other Routines Called 
ARG$ and L$33 

LOGICAL COMPLEMENT (N$33) 

Purpose 

N$33 is used to obtain the complement of a logical argument by changing the value 
of the least significant bit in Register A from to 1 or from 1 to 0. 

Storage Requirements 



N$33 requires 4, (4J locations (Rev. A). 

Usage 

The calling sequence for N$33 is as follows. 
CALL N$33 

LOGICAL OR FROM MEMORY (L$33) 



Pur 



pos 



L$33 is used to form an inclusive OR from memory with the argument in Register A. 
The argument in Register A is first exclusive ORed with the argument from memory. The 
result is ANDed with the argument from memory and this result is then exclusive ORed 
with the argument from memory, thus forming the inclusive OR. 

Storage Requirements 

L$33 requires 12, (14g) locations (Rev. A). 

Usage 

The calling sequence for L$33 is as follows. 

CALL L$33 
DAC ARG1 
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SECTION VII 
MATHEMATICAL LIBRARY 



All mathematical routines in the DDP- 51 6 library are listed in Table 7-1. Each 
routine is listed alphabetically according to the function that it performs. Information given 
for each routine includes a mnemonic name, calling sequence, mode, errors, accuracy and 
timing (where available), storage locations required, and other routines used. The actual 
mnemonic name for a routine is given in the calling sequence in Column 3. The routine 
identification in Column 2 is not necessarily the entry for the routine indicated in Column 1 , 
but rather the identification of the routine that contains it. 

After each call, in Column 3, is the statement DAC Arg (1 , 2 or n). DAC Arg 1 
indicates that the program requires only one argument, and the address of that argument 
appears to the right of the DAC. DAC Arg 2 indicates that the program requires two argu- 
ments. In this case, the first argument is in the appropriate accumulator, and the address 
of the second argument appears to the right of the DAC. DAC Arg n indicates that the pro- 
gram requires more than two arguments. The first argument is in the appropriate accu- 
mulator, the address of the second is to the right of the first DAC, and the following lines 
contain additional DAC statements with the addresser, of the additional arguments. There 
are four accumulators, as follows. 

The integer accumulator is Register A. 

The single-precision, or real, accumulator includes the Registers A and B, with 
the sign in A , the exponent in A , and the fraction in A 10 _i6 and B l-16* 

The double-precision accumulator is memory locations 75 g , 76 g and 77 g , with the 
sign in bit position 1 of 75 ft , the exponent in bit positions 2-9 of 75 g , and the fraction in bit 
positions 10-16 of 75 g , 1-16 of 76 g , and 1-16 of 77 g . 

The complex accumulator is memory locations 74 g through 77 g . The sign of the 
real part is in bit position 1 of 74 g , the exponent is in bit positions 2-9 of 74 g , and the 
fraction is in bit positions 10-16 of 74 and bit positions 1-16 of 75 g . The imaginary part 
of the complex number occupies word's 76 g and 77 g in the same manner. 

When you are not using FORTRAN IV and you wish to use an integer or single- 
precision subroutine that requires more than one argument, you can place the first argument 
in Register A, or Registers A and B, via LDA, or subroutine L$22. 

For integer: LDA (address of integer variable) 
For single-precision: CALL L$22 

DAC ARG1 

With double- precision and complex subroutines, you can load the accumulators via 
the L$66 and L$55 subroutines, as follows. 
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For double-precision: 

CALL L$66 

DAC (address of first word of double-precision argument) 

For complex: 

CALL L$55 

DAC (address of first word of complex argument) 

Column 4, Mode, gives a. symbolic representation of the mathematical function 
accomplished by each routine. Abbreviations that are used are defined as follows. 

C Complex number 

R Single- precis ion number 

I Integer 

D Double- precision number 

The symbolic expressions given are to be interpreted in the conventional mathe- 
matical manner. The portion of the expression to the left of the equal sign is the result of 
the function, and the portion on the right is the actual function performed. For example, 
in the first expression in the table R = CABS (C) would be read R is a function of C, where 
R is the resulting single- precis ion number, CABS (or complex absolute value) is the function 
performed, and (C) is the input argument (a complex number). 

The last column in Table 7-1 gives other routines used by the routine listed in 
Column 1. For routines coded in DAP format, "Other Routines Used" includes only those 
called by the CALL pseudo-operation. For routines that are coded in FORTRAN, routines 
that are called by the FORTRAN compiler to fulfill the FORTRAN coding are given, in 
addition to those called by the FORTRAN source coding. 

Ar explanation of conventions used throughout the library for transferring argu- 
ments to and from routines is presented in FORTRAN IV Library Introduction (3C Doc. No. 
180092000). The FORTRAN IV Manual (3C Doc. No. 130071364) describes the distinction 
between functions and subroutines and provides instructions for writing programs that 
call both. 
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SECTION VIII 
INPUT/OUTPUT LIBRARY 



All routines in the DDP-516 Input/ Output Library are described in this section. 
The purpose, storage requirements, and use (or calling sequence) is given for each 
routine. "Method", "Errors", and "Other Routines Used" are also included as applicable. 

Standard I/O library mnemonics consist of four characters as follows. 

a. The first character is generally either an I (for input) or an O (for output). 

b. The second character (dollar sign) identifies the routine as a library routine. 

c. The third character designates the device 

A ASR-33/ASR-35 

C Card reader or card punch 

P Paper tape reader or paper tape punch 

M Magnetic tape transport 

d. The fourth character specifies the mode or function 

A ASCII 

B Binary 

E Eject (or end of file) 

H Heading 

I Initialize • 

P Punch 

S End of message 

F File 
The magnetic tape control and conversion mnemonics are an exception to the general rule 
for standard I/O library routines and are designated as follows. 

CONTROL CONVERSION 

C$MR Rewind C$6T08 IBM to ASCII 

C$BR Backspace record C$8T06 ASCII to IBM • 

C$BF Backspace file M$UNIT Physical to logical 
C$FR Forward record 
C$FF Forward file 

Routines that are FORTRAN IV links are identified by F$ as the first two characters of 
the mnemonic. 
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FORTRAN IV INPUT/OUTPUT .SUPERVISOR (P4-IOS) 

Purpose 

F4-IOS services all I/O requirements of the FORTRAN IV compiler. The compiler 
makes use of five entry points to F4-I0S as follows. 

F4$INT Initialization 

F4$IN Input 

F4$OUT Binary output 

F4$SYM Symbolic 'out put 

F4$END Compilation complete 

This program will operate on a standard DDP-5 16 with a minimum of 8K storage. 
Storage R e q u i r e m e n t s 



F4-IOS requires 359 in (547 ) locations. Locations 100-115 are also initializer! for 
use by the compiler. 

Usage 

Refer to the program listing, 30 Doc. No. 180016000 Rev. A, in the FORTRAN IV 
compiler manual for complete instructions on use. 

INPUT/OUTPUT SUPERVISOR (IOS-16B) 

Purpose 

IOS-ioB performs the necessary supervision and control of DAP- 16 assembler 
input/output device requirements. IOS-16B consists of 15 entries that are used by the 
DAP assembler , as required. Each entry returns control to the assembler when its 
function has been accomplished. 

S to ra ge Re qu i rements 

lOS-loB requires 747,^(1353,,) locations. 

1 u o 

Usage 

Refer to program listing, 3C Doc. No. 1803Z9000 Rev. A for complete details on 
operation and usage. 
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FORTRAN IV SCANNER AND CONVERSIONS ROUTINE (F$IO) 

Purpose 

F$IO accommodates the proper input/output device to accomplish the appropriate 
input/output conversion, as required, and to control the filling and emptying of the input/ 
output buffer. This routine contains the argument transfer subroutine (F$AR), and the 
buffer closeout subroutine (F$CB). 

Storage Requirements 

F$IO requires 1255 10 (2347 g ) locations. 

Usage 

Refer to program listing, 3C Doc. No. 182618000 Rev. A, for complete instructions 
on use. 

Other Routines Called 



F$ER 
ASR-33 TYPEWRITER INPUT DRIVER (F$R1) 

Purpose 

F$R1 provides linkage between the FORTRAN calling program and the I/O control 
subroutine (F$IO) and provides the driving logic needed to input on the typewriter keyboard 
by calling I$AA. 

Storage Requirements 

F$R1 requires 10 10 ( 12 g) locations - 

Calling Sequence 

CALL F$R1 

DAC N (location of descriptor list given by FORTRAN format 

statement) 

Method 

Refer to program listing, 3C Doc. No. 182610000 Rev. A, for details on the 
method used. 

Other Routines Called 



F$IO, I$AA 
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ASR-33 TYPEWRITER OUTPUT DRIVER (F$W1) 



Purpose 



F$W1 provides linkage between the FORTRAN calling program and the I/O control 
subroutine (F$IO). It also provides the driving logic needed to output on the ASR-33 type- 
writer by calling 0$AC, 0$AP, and 0$AF. 

Stora ge Requirements 

F$\V1 requires 61 (75 ) locations. 

Calli ng Sequence 

CALL F$W1 

DAC N (location of format descriptor list given by 

FORTRAN format statement) 

M ethod 

Refer to program listing, 3C Doc. No. 182611000, Rev. A, for details on method 
used. 

Other Routines Called 



F$IO, 0$AC, 0$AP, 0$AF 
PAPER TAPE READER INPUT DRIVER (F$R2) 

Purpose 

F$R2 provides linkage between the FORTRAN calling program and the I/O control 
subroutine (F$IO) and the driving logic needed to input from the paper tape reader by 
calling I$PA. 

Sto r age Req ui r e m e nt s 

F$R2 requires 10,^(12^) locations. 

Calling Sequence 

CALL F$R2 

DAC N (Location of the descriptor list given by FORTRAN format 

statement, or 00000 if input is in binary format) 

(Return) 
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Method 

Refer to program listing, 3C Doc. No. 182612000 Rev. A, for details on method 
used. 

Other Routines Called 



F$IO and I$PA. 
PAPER TAPE PUNCH OUTPUT DRIVER (F$W2) 

Purpose 

F$W2 provides linkage between the FORTRAN calling program and the I/O control 
subroutine (F$IO) and the driving logic needed to output on the paper tape punch by calling 
0$PF, 0$PC, and 0$PP. 

Storage Requirements 

This routine requires 46 1() (56g) locations. 

Calling Sequence 

CALL F$W2 

DAC N (Location of descriptor list given by FORTRAN format 

statement, or 00000 if output mode is binary) 

(Return) 

Method 

Refer to program listing, 3C Doc. No. 182613000 Rev. A, for details on method used. 

Other Routines Called 

F$IO, 0$PF, 0$PC, and 0$PP. 

CARD READER INPUT DRIVER (F$R3) 

Purpose 

F$R3 provides linkage between the FORTRAN calling program and the I/O control 
subroutine (F$IO) and the driving logic needed to input from the card reader by calling 
I$CA or I$CB. 

Storage Requirements 

F$R3 requires 10 10 (12 g ) locations. 
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Calling S t-quenc e 

CALL F$Ri ,;, 

DAC N (Location of descriptor list given by FORTRAN, format 

statement, or 00000 if input is in binary format) 

(Return) 

Method 

Refer to the program listing, 3C Doc. No. 182614000 Rev. A, for details on method 
used. 

Errors 

Card reader error. 

Other Routines Called 



F$IO, I$CA 
FORTRAN MAGNETIC TAPE INPUT DRIVER (F$R5-9) 

Purpose 

F$R5-9 controls reading of magnetic tape by connecting the FORTRAN calling prograr 
with the I/O control routine (F$IO) and the standard magnetic tape read subroutines. 

Storag e R equirements 

F$R5-9 requires 81 1Q (121 8 ) locations. 

Calling S equence 

GALE F$Rx (Where x=5, 6, 7, 8, or 9) 

DAC N (Location of description list given by FORTRAN format 

statement or 00000 if output mode is binary. ) 

Method 

Refer to the program listing, 3C Doc. No. 180306000 Rev. A for details on method 
used. 

FORTRAN MAGNETIC TAPE OUTPUT DRIVER (F$W5-9) 

Purpose 

F$W5-9 controls writing of magnetic tape by connecting the FORTRAN calling pro- 
gram with the I/O control routine (F$IO) and the standard magnetic tape write subroutines. 
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Storage Requirements 

F$W5-9 requires 58, (72 8 ) locations. 

Calling Sequence 

CALL F$Wx (Where x 5, 6, 7, 8, or 9) 

DAC N (Location of descriptor list given by FORTRAN format 

statement, or 00000 if output mode is binary. ) 

Method 

Refer to the program listing, 3C Doc. No. 180307000 Rev. A, for details on method 



used. 



CONVERT IBM TAPE CODE TO ASCII (C$6T08) 
Purpose 

C$6T08 converts standard magnetic tape code to ASCII. The data buffer is assumed 
to initially contain data in IBM tape code, stored two characters per word in bit positions 
1-6 and 7-12 (data in bits 13-16 is ignored). After conversion, the contents of the buffer 
is replaced on a character -by-character basis. The character originally occupying bit 
positions 1-6 of a word will occupy bit positions 1-8 of the same word. The character 
originally occupying bit positions 7-12 will occupy bit positions 9-16. 

Storage Requirements 

C$6T08 requires 63, (77 Q ) locations 
10 o 

Calling Sequence 



CALL 


C$6T08 


DAC 


(Buffer address) 


DEC 


(Number of words in buffer) 


Method 





Refer to the program listing, 3C Doc. No. 180091000, Rev C for details on the 
method used. 

CONVERT ASCII TO IBM TAPE CODE (C$8T06) 

Purpose 

C$8T06 converts ASCII to standard magnetic tape code. The data buffer is 
assumed to initially contain ASCII data stored in bits 1-8 and 9-16. After conversion, the 
contents of the buffer is replaced on a character -by-character basis. The character 
originally occupying bit positions 1-8 of a word will, after conversion, occupy bit positions 
1-6 of the same word. The character originally occupying bit positions 9-16 will occupy 
bit positions 7-12. Bit positions 13-16 of each word will be set to zero. 
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Storage Requirements 

C$8T06 requires 64 ln (100 o ) locations. 

Calling Sequence 

CALL C$8T06 

DAC (Buffer address) 

DEC (Number of words in buffer) 

Method 



Refer to the program listing, 3C Doc. No. 180082000 Rev B for details on method 
used. 

VARIABLE INPUT DRIVER SELECTION (F$RN) 

Purpose 

F$RN controls the input devices for variable input device numbers. The value of 
the input device number is checked for correct limits .and then used to determine the 
entry position of a jump table. The jump table transfers to the proper F$R - subroutine. 

Storage Requirements 

F$RN requires 31, (37~) locations. 

Calling Sequence 

LDA D (location of device number) 

CALL F$RN 

DAC N (location of descriptor list given by FORTRAN statement, 

or 00000 if format is binary) 
(Return) 

Errors 

d < 1, or d > 9. Characters IO will be typed. Computer will stop. To continue, 
enter acceptable value in Register A and press START pushbutton. 

Other Routines Called 



F$R1 through 3, and F$R5 through 9. 
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VARIABLE OUTPUT DRIVER SELECTION (F$WN) 

Purpose 

F$WN controls the output drivers for variable output device numbers. The value 
of the output device number is checked for correct limits and then used to determine the 
entry position of a jump table. The jump table transfers to the proper F$W - subroutine. 

Storage Requirements 

F$WN requires 27 10 ( 33 q) locations 

Calling Sequence 

LDA D (location of device number) 

CALL F$WN 

DAC N (location of descriptor list given by FORTRAN format 

statement, or 00000 if format is binary) 

Errors 

d < 1, or d> 9. Characters IO will be typed. Computer will stop. To continue, 
enter an acceptable value into Register A and depress the START pushbutton. 

Other Routines Called 



F$R1 through 9. 
ASR-33 TAPE READER, ASCII (I$AA, I$AI) 

Purpose 

I$AA reads ASCII paper tape, using the ASR-33 paper tape reader. If I$AA is not 
initialized by I$AI, it will assume that the input buffer is 40 words long and that there 
are three tab settings corresponding to character positions 6, 12, and 30 (DAP 516 source 
format). 

Storage Requirements 

I$AA requires 127 1Q (177g) locations. 
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Calling Sequence 

CALL I$AI 

Initialization - DEC (number of words in input buffer) 

DEC (number of tabs in following table, if any) 

DEC TAB (1) 

DEC TAB (2) 



DEC TAB (n) 

(Normal return) 
Read data - CALL I$AA 



DAC (Data buffer address) 

(end of message return) 
(Normal return) 



Method 



Refer to the program listing, 3C Doc. No. 189001000, Rev C, for details on the 
method used, 

ASR-33 TAPE READER, BINARY (I$AB, I$ABI) 

Purpose 

I$AB reads binary paper tape by using the ASR-33 paper tape reader. This routine 
is initialized by using the I$ABI entry. The address of the 60 -word buffer into which the 
binary data will be read appears in the variable field following the CALL pseudo -operation. 

Storage Requirements 



I$AB requires 121 (171 ) locations. 
10 o 



Calling Sequence 



Initialization - CALL I$ABI 
DAC (Data) 

(End of message return) 
(Normal return) 

Read data - CALL I$AB 

DAC (Data) 

(End of message return) 
(Normal return) 
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Errors 

Oversize input record. Computer will halt. Check input tape for correct control 
characters between records. Press START pushbutton to take normal return. 

Method 



Refer to the program listing, 3C Doc. No^ 189002000, Rev. B, for details on the 
method used. 

ASR-33 TYPEWRITER CONTROL PACKAGE (0$AP, 0$AC, 0$AF) 

Purpose 

This routine performs one of three ASR-33 control functions depending on which 
entry is used. The entry mnemonics and corresponding control functions are as follows. 

0$AP Type a line 

0$AC Carriage return 

0$AF Advance to next line 

Storage Requirements 

This routine requires 54,^(66^) locations. 

Calling Sequence 



(1) 


CALL 


0$AP 




DAC 


ARG1 


(2) 


CALL 


0$AC 


(3) 


CALL 


0$AF 


Method 







(Where ARG1 is the location of the buffer 
to be typed out) 



Refer to the program listing, 3C Doc. No. 180255000, Rev. A for details on 
method used. 

ASR-33 TYPEWRITER - LISTING AND HEADING ROUTINES (0$LL, 0$HH) 

Purpose 

These routines type out listings on the ASR-33 typewriter. 0$LL is called to type 
a line of data, and 0$HH is called to type out a heading. This routine backscans each 
buffer to edit trailing blanks. Refer to Doc. No. 180774000 Rev B for a program listing. 
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Storage Requirements 

0$LL and 0$HH require 147 i (223J locations. 

10 o 

Calling Seque nce 

Listing CALL 0$LL 

DAC (Data Line Address) 

(Normal return) 
Heading CALL 0$HH 

DAC (Head Heading Address) 

(Normal return) 

ASR -33 TAPE PUNCH, ASCII (0$AA, 0$AI, 0$AS, 0$ALDR) 

Purpo se 

0$AA punches ASCII paper tape using the ASR -3 3 paper tape punch. This routine 
will assume, if not initialized by 0$AI, that the data buffer is 40 words long and that there 
are three tab positions corresponding to character positions 6, 12, and 30 (DAP-516 
source format). The 0$AS entry is used to punch end of message, and the 0$ALDR entry 
is used to punch 10 inches of blank tape. 

Storage Requirement s 

These routines require 121^(171 ) locations. 

Call ing Sequence 

Initialization - CALL 0$AI 

DEC (Number of words in data buffer) 

DEC (Number of tabs in following table, if any) 

DEC TAB (1) 

DEC TAB (2) 



DEC TAB (n) 

(Normal return) 
Data - CALL 0$AA 

DAC (Data buffer address) 

(Normal return) 

End of 

message - CALL 0$AS 

Leader ~ CALL Q$ALDR 
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Method 

Refer to program listing, 3C Doc No. 189003000, Rev C for details on method used. 

ASR-33 TAPE PUNCH, BINARY (0$AB, 0$AS) 

Purpose 

0$AB punches binary paper tape using the ASR-33 paper tape punch. The 0$AS 
entry is used to punch end of message. 

Storage Requirements 

0$AB requires 87 J127.) locations. 

Calling Sequence 

Punch Data - CALL 0$AB 

DAC (Data) 

(Normal return) 

End of 

message - CALL 0$AS 

(Normal return) 
Refer to program listing, 3C Doc. No. 189004000, Rev B for complete details on use. 

PAPER TAPE READER, ASCII (I$PA, I$PI) 

Purpose 

I$PA reads paper tape in ASCII format by using the high-speed paper tape reader. 
The I$PI entry is used for initialization." If not initialized, the read routine will assume 
that the input buffer is 40 words long and that there are three tab settings corresponding 
to character positions 6, 12, and 30 (DAP-516 source format). 

Storage Requirements 

I$PA and I$PI require 117 (l65 g ) locations. 

Calling Sequence 

Initialization - CALL I$PI 

DEC (Number of words in input buffer) 

DEC (Number of tabs in following table, if any) 

DEC TAB ( 1) 

DEC TAB (2) 
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DEC TAB (n) 

(Normal return) 
Raid Data » CALL I$PA 

DAC (Data buffer address) 

(End of message return) 
(Normal return) 

'vaor to program listing, 3C Doc. No. 189006000, Rev D for complete information 

on usi\ 

PAPER TAPE READER, BINARY (I$PB, I$PI) 

Purpose 

I$PB roads paper tape in binary format by using the high-speed paper tape reader. 
The I$PI entry is used for initialization. The address of the 60 -word buffer into which 
the binarx information will be read appears in the variable field following the CALL 
p s e u d o - o p e r a t ion. 

Storage Requirements 



ISP3 requires 109 1Q ( i55 8 > locations. 

Calling Sequence 

Initialization - CALL I$PI 

DAC (Data) 

(End of message return) 

(Normal return) 
Data read - CALL I$PB 

DAC (Binary data address) 

(End of message return) 

(Normal return) 

Errors 

Oversize input record. Computer will halt. Check input tape for correct control 
characters between records. Press START pushbutton to take normal return. 

Method 



Refer to the program listing, 3C Doc. No. 189007000, Rev B for details on the 
method used. 
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PAPER TAPE PUNCH CONTROL PACKAGE (0$PP, 0$PC, 0$PF) 

Purpose 

These routines perform one of three paper tape punch control functions depending 
on which entry is used. The entry mnemonics and corresponding control functions are 
as follows. 

0$PP Punch a line 

0$PG Punch carriage return 

0$PF Advance to next line 

Stora ge Requirements 

These routines require 5 1 jnt^g) locations. 



Calling Sequence 



CALL 


o$pp 


DAC 


ARG1 


CALL 


o$pc 


CALL 


0$PF 


Method 





(Where ARGl is the location of 
the buffer to be punched out) 



Refer to the program listing, 3C Doc. No. 180257000 Rev. A, for details on the 
method used. 

PAPER TAPE PUNCH, ASCII (0$PA, 0$PI, 0$PS, 0$PLDR) 

Purpose 

0$PA punches paper tape in ASCII format by using the high-speed paper tape punch. 
The package also has provisions for initialization (0$PI), punching end of record (0$PS), 
and punching leader (0$PLDR), depending on which entry is used. If not initialized, the 
punch routine will assume that the data buffer is 40 words long and that there are three 
tab settings corresponding to character positions 6, 12, and 30 (DAP-516 source format). 

Storage Requirements 

These routines require 120 10 (170 g ) locations. 
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Calling Sequences 

Data - CALL 0$PA 

DAC (Data buffer address) 

(Normal return) 

Initialization - CALL 0$PI 

DEC (Number of words in data register) 

DEC (Number of tabs in following table, if any) 

DEC TAB (1) 

DEC TAB (2) 



DEC TAB (n) 

(Normal return) 
End of record - CALL 0$PS 
Leader - CALL 0$PLDR 

Refer to the program listing, 3C Doc. No. 189008000 Rev. C for complete details 
on use. 

PAPER TAPE PUNCH, BINARY (0$PB, 0$PS) 

Purpose 

0$PB punches paper tape in binary format using the high-speed paper tape punch. 
This paxkage also has provisions for punching end of message by using the 0$PS entry. 

Storage Requirements 

G$PB requires 88, (130 R ) locations. 

Calling Sequence 

Data - CALL 0$PB 

DAC Data (Binary data address) 

(Normal return) 

End of message - CALL 0$PS 

(Normal return) 

Refer to the program listing, 3C Doc. No. 189009000 Rev. B, for complete details 
on use. 
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PAPER TAPE PUNCH - LISTING AND HEADING ROUTINES (0$PL, 0$PH) 

Purpose 

0$PL punches listings on the paper tape punch, 0$PL is called to punch a line of 
output, and 0$PH is called to punch a heading. This routine backscans each buffer to 
edit trailing blanks. Refer to 3C Doc. No. 181479000 for a program listing. 

Storage Requirements 

0$PL and 0$PH require 141 1Q (215 8 ) locations. 

Calling Sequence 

Listing - CALL 0$PL 

DAC Data (Line address) 

(Normal return) 

Heading - CALL 0$PH 

DAC Head (Heading address) 

(Normal return) 
CARD READER, ASCII (I$CA) 

Purpose 

I$CA reads ASCII (Hollerith) cards using the DDP-516 card reader. One card will 
be read on each I$CA entry. The data will be stored two characters per word in a 40- 
word data buffer after being converted from the 6-bit code generated by the card reader 
to the 8-bit ASCII code. 

Storage Requirements 

I$CA requires 75, (113g) locations. 

Calling Sequence 

CALL I$CA 

DAC (Data buffer address) 

(End of file return) 

(Normal return) 
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Errors 

Card reader empty, jammed, or in manual. 

Method 



Refer to the program listing, 3C Doc. No. 189011000 Rev. C, lor details on method 
used. 

CARD READER, BINARY (I$CB) 

Purpose 

I$CB reads column binary cards using the DDP-516 and reader. 

Storage Requirements 

This routine requires 42^(52^ locations. 

Callin g Sequence 

CALL I$CB 

DAC (Data address - first word of 6 -word block) 

(End of file return) 

(Normal return) 

Errors 

Card reader empty, jammed, or in manual. 

Method 

Refer to the program listing, 3C Doc. No. 180609000 Rev. B, for details on method 
used. 

MAGNETIC TAPE READ PACKAGE (I$MA, I$MB, I$MC) 

Purpose 

To read a magnetic tape in one of three modes depending on which entry is used. 
The entry mnemonics and corresponding read modes are as follows. 

I$MA Read in BCD mode, 2 characters per word 
I$MB Read in binary mode, 2 characters per word 
I$MC Read in binary mode, 3 characters per word 
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Storage Requirements 

These routines require 104. (150 g ) locations. 

Calling Sequence 



CALL 


I$Mx 


(where x is A, B, or C) 


DAC 


BUFA 


(Buffer address) 


DEC 


WC 


(Word count) 


DEC 


N 


(Logical type unit) 



(Record unreadable return) 
(End of tape return) 
(End of file return) 
(Normal return) 

Method 

Refer to the program listing, 3C Doc. No. 182604000 Rev. B, for details on the 
method used. 

Other Routines Called 



M$UNIT 
MAGNETIC TAPE CONTROL PACKAGE (C$MR, C$FR, C$BR, C$FF, C$BF) 

Purpose 

This routine performs one of five magnetic tape control functions, depending on 
which entry is used. The entry mnemonics and corresponding control functions are as 
follows. 

C$MR - Rewind tape 
C$FR - Forward space one record 
C$BR - Backspace one record 
C$FF - Forward space one file 
C$BF - Backspace one file 

Storage Requirements 

This routine requires 67, n (103 ft ) locations. 
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Calling Sequence 



For 


C$MR, 


, C$FF, or < 




CALL 


C$xx 




DEC 


N 




(Norm 


al return) 


For 


C$FR 


or C$BR - 




CALL 


C$xx 




DEC 


N 



(Where xx is MR, FF, or BF) 
(Logical tape unit) 



(Where xx is FR or BR) 
(Logical tape unit) 

(End of file return) 

(Normal return) 

Method 

Refer to the program listing, 3C Doc. No, 182606000 Rev. B, for details on the 
method used. 

Other Routines Called 



M$UNIT 
MAGNETIC TAPE WRITE PACKAGE (0$MA, 0$MB, 0$MC, 0$ME) 

Purpose 

These routines are used to write a. binary tape in one of three modes or to write 
an end of file depending on which entry is used. The entry mnemonics and corresponding 
write modes are as follows. 

OJMA Write in BCD mode, 2 characters per word 

0$MB Write in binary mode, 2 characters per word 

0$MC Write in binary mode, 3 characters per word 

G$ME Write end of file 



Storage Requirements 

These routines require 101,^(145^) locations. 

Calling Sequence 



For writing a magnetic tape 


in a BCD or binary mode, 


CALL 


0$Mx 


(Where x is A, B, or C) 


DAC 


BUFA 


(Buffer address) 


DEC 


WC 


(Word count) 
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(End of tape return) 

(Normal return) 

For writing an end of file on magnetic tape, 

CALL 0$ME Call subroutine 

DEC N Logical tape unit 

Method 

Refer to the program listing, 3C Doc. No. 182605000 Rev. B, for details on the 
method used. 

Other Routines Called 



M$UNIT 
MAGNETIC TAPE UNIT CONVERSION ROUTINE (M$UNIT) 

Purpose 

M$UNIT provides a physical tape number associated with a logical tape when 
called by the magnetic tape read, write and control routines. 

Storage Req uirements 

This routine requires a variable number of locations depending upon the system 
configuration. (Usualsize is 15, ~. ) 

Calling Sequence 

(Load logical tape number in Register A - bits 13-16. ) 

CALL M$UNIT 

(Physical tape number will be stored in Register A - bits 14-16. ) 

NOTE 

The logical tape number must be between 1 and 8. 
The physical tape number will be between and 7. 

Method 

Refer to the program listing, 3C Doc. No. 180228000, Rev. B, for details on the 
method used. 

FORTRAN MAGNETIC TAPE BACKSPACE DRIVER (F$F5-9) 

Purpose 

F$F5-9 controls backspacing of magnetic tape by connecting the FORTRAN calling 
program with the I/O control routine (F$IO) and the standard magnetic tape backspacing 
subroutines. 
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Storage Requirements 

F$P5-9 requires 4Z (52 ) locations. 

Calling Sequence 

CALL F$Fx (Where x = 5, 6, 7, 8, 9, or n. ) 

Method 

Refer to the program listing, 3C Doc. No. 180310000 Rev. A, for details on method 
used. 

FORTRAN MAGNETIC TAPE END-OF-FILE DRIVER (F$D5-9) 

Purpose 

F$D5-9 controls writing end-of-file marks on magnetic tape by connecting the 
FORTRAN calling program with the I/O control routine (F$IO) and the standard magnetic 
tape end-file subroutine. 

Storage Requirements 

F$D5-9 requires 27 iq(33o) locations. 

Calling Sequence 

CALL F$Dx (Where x = 5, 6, 7, 8, 9, or n. ) 

Method 

Refer to the program listing, 3C~Doc. No. 180308000 Rev. A, for details on 
method used. 

FORTRAN MAGNETIC TAPE REWIND DRIVER (F$B5-9) 

Purpose 

F$B5-9 controls rewinding of magnetic tapes by connecting the FORTRAN calling 
program with the standard magnetic tape rewind subroutine. 

Storage Requirements 

F$B5-9 requires 27, (33J locations. 
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Calling Sequence 

CALL F$Bx (Where x 5, 6, 7, 8, 9, or n. ) 

Method 

Refer to the program listing, 3C Doc. No. 180309000 Rev. A, for details on 
method used. 
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SECTION IX 
ERROR MESSAGES 



LOADING MESSAGES 

A message, which indicates the reason for halting, is always typed whenever 
loading halts. See Table 5-1 for an explanation of these messages. 



DAP- 16 ASSEMBLY PROGRAM 

DAP- 16 is able to detect many types of clerical errors commonly made in coding 
programs. These errors are indicated by an appropriate error code printed in the left 
margin of the assembly listing. Examples of errors that are detected are shown in 

Table 9-1. 

Errors in a field will generally result in that field being assembled as a 0. In the 
case of multiply defined symbols, the first symbol definition is used. 

Table 9-1. 
Error Messages Generated by the DAP- 16 Assembly Program 



Error 
Message 



C 

F 
L 
M 
N 
O 
R 
S 

T 
U 
V 

X 



Condition 



Address field missing where normally required, or error in address 

format 
Erroneous conversion of a constant or a variable field in improper format 
Major formatting error 

Location symbol missing where required, or error in location symbol 
Multiply defined symbol 

Missing name (main program or subroutine) 
Operation code missing or in error 
Relocation assignment error 
Address of variable field expression not in sector being processed or 

sector zero (applicable only in load mode) 

Improper use of or error in index field 

Undefined symbol 

Unclassified error in variable field of multiple field pseudo-operator 

(i.e., DEC, OCT, etc.) 
Symbol table or literal table exceeded 
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FORTRAN COMPILER PROGRAM 
Error Mess age 

Any time the compiler detects an error in the format of a FORTRAN statement, a 
two line error message is typed or printed in the listing. If the error is of a type that 
is recognized as soon as it is encountered, the first line is a duplicate of the line in which 
the error occurred. If the error cannot be recognized until later in the program, the 
line at which the error is recognized contains a left pointing arrow ( ^ ) in column 6. In 
either case, the second extra line consists of a row of asterisks broken by the word 
ERROR in the left-hand margin and an error diognostic in approximately the same 
horizontal position as the error. 

The diagnostic messages generated by the FORTRAN IV compiler program to indicate 
coding errors are listed in Table 9-2. Some errors are recoverable and their presence 
will not prevent execution of the program. In most cases, however, a program containing 
such errors will generate incorrect or ambiguous results. It is recommended that all 
coding errors be corrected before a program is run. 
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Table 9-2. 
Error Messages Generated by the FORTRAN Compiler Program 



Error 






Message 


Condition 




AE 


Arithmetic statement function has over 10 arguments 




AG 


Subroutine or array name not in an argument 




AR 


Item not an array name 




BD 


Code generated within a block data subprogram 




BL 


Block data not first statement 




CE 


Constant's exponent exceeds 8 bits (over 255) 




CG 


Compiler or computer error caused a jump to 00000 




CH 


Improper terminating character (punctuation) 




CM 


Comma outside parentheses, not in a DO statement 




CN 


Improper constant (data initialization) 




CR 


Illegal common reference 




DA 


Illegal use of a dummy argument 




DD 


Dummy item appears in an equivalence or data list 




DM 


Data and data name mode do not agree 




DT 


Improper DO termination 




EC 


Equivalence group not followed by comma or CR (carriage 


return) 


EQ 


Expression to left of equals, or multiple equals 




EX 


Specification statement appears after cleanup 




FA 


Function has no arguments 




FD 


Function name not defined by an arithmetic statement 




FR 


Format statement error 




FS 


Function/ subroutine not the first statement 




HF 


Hollerith character count equals zero 




HS 


Hollerith data string extends past end of statement 




IC 


Impossible common equivalencing 




ID 


Unrecognizable statement 




IE 


Impossible equivalence grouping 




IF 


Illegal IF statement type 




IN 


Integer required at this position . 




IT 


Item not an integer 




MM 


Mode mixing error 




MO 


Data pool overflow 




MS 


Multiply defined statement number 




NC 


Constant must be present 




ND 


Wrong number of dimensions 




NF 


No reference to format statement 




NR 


Item not a relative variable 




NS 


Subprogram name not allowed 




NT 


Logical NOT, not an unary operator 
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Table 9-2. (Cont) 
Error Messages Generated by the FORTRAN Compiler Program 



Error 
Message 



NU 

NZ 

OP 

PA 

PH 

PR 

PW 

RL 

RN 

RT 

SC 

SP 

ST 

su 

TF 
TO 
UO 

US 

VD 

VN 



Condition 



Name already being used 

Non-zero string test failed 

More than one operator in a row 

Operation must be within parentheses 

No path leading to this statement 

Parentheses missing in a DO statement 

* Preceded by operator other than another* 

More than 1 relational operator in a relational example 

Reference to a specification statement's number 

Return not allowed in main program 

Statement number on a continuation card 

Statement name misspelled 

Illegal statement number format 

Subscript incrementer not a constant 

"Type" not followed by "Function" or list 

Assign statement has word TO missing 

Multiple + or - signs, not as unary operators 

Undefined statement number 

Symbolic subscript not dummy in dummy array or 
symbolic subscript appears in a non-dummy array 

Variable name required at this position 



L IBRARY SUBROUTINES 

The subroutines in the standard FORTRAN IV library are designed for use with a 
machine configuration without the high-speed multiply and divide hardware option. Sub- 
routine arguments are one of four types: integer, real, double, or complex. 

If an error is detected by a subroutine, the object error diagnostic subroutine 
(F$ER) will be called. Normally, a two-character mnemonic will be typed on the 
ASR-33/35 and the computer will halt. If SENSE SWITCH 3 is on, F$ER will return 
control to the calling subroutine which will exit, with meaningless results, in most 
cases,, Table 9-3 lists those subroutines that call on F$ER and their associated error 
message. 
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Table 9-3. 
Error Messages Generated by the Library Subroutines 



Error 






Message 


Condition 


Generating Subroutine 


DA 


Arithmetic Overflow 


A$66/S$66 (Double Add/Sub) 


DL 


Negative or Zero Argument 


DLOG/DLOG10 (Double Logarithm) 


DM 


Arithmetic Overflow or Zero 
Divisor 


M"$66/D$66 (Double Mult/Div) 


EQ 


Arithmetic Overflow 


A$81 (Add Integer to Double Exponent) 


EX 


Exponent Overflow 


EXP (Real Exponential) 


FE 


Format Error 


F$IO (Format Scanner and Conversions) 


II 


Result Greater (2**15) -1 


E$ll (Integer Raised to Integer) 


IN 


Input Error 


F$IO (Format Scanner and Conversions) 


RI 


Exponent Greater than 15 


C$21 (Convert Real to Integer) 


SA 


Arithmetic Overflow 


A$22/S$22 (Real Add/Sub) 


SD 


Arithmetic Overflow or Zero 
Divisor 


D$22 (Real Div) 


SM 


Arithmetic Overflow 


M$22 (Real Multiply) 


SQ 


Negative Argument 


SQRT (Real Square Root) 
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SECTION X 
PAPER TAPE FORMATS 



This section contains descriptions of the paper tape formats that are used as a 
principle input/output medium for the DD1?-516 computer. Data is recorded on paper tape 
by groups of holes arranged in a definite format along the length of the tape, f Paper tape 
is a continuous recording medium, as opposed to cards which are fixed in length, and the 
length of data records is limited only by the input/output requirements of the system. A 
vertical column of holes extending across the tape is referred to as a frame. A horizontal 
row of holes extending the length of the tape is referred to as a channel. For paper tapes 
punched and read by the DDP-516 system, there are eight channel-hole positions per frame, 
and one small sprocket hole. (See Figure 10-1.) 



CHANNELS -< 



r 



FRAME 



1 \ O 

2 I O 

3 / O 
Voooooooooooooooooooooooooooooooo/ 

5 / O 

6 \ O 

7 / O 

8 ) O 



SPROCKET 
HOLES 



Figure 10-1. General Paper Tape Format 

The format descriptions given in this section apply to tapes punched by the high- 
speed paper tape punch, as well as those punched by the ASR-33/3 5 paper tape punch. 
Paper tape formats used with PDP-516 systems fall into two main categories: an ASCII 
format (for punching source code) and a 4/6/6 format (for punching object code). 

ASCII Format 



ASCII format is an octal code that uses eight channels to define one character per 
frame. Each frame is read from channel 8 to channel 1 in bit groups of 2/3/3 as 
illustrated in Figure 10-2. Two ASR-33/35 typewriter control codes, '2 12 for line feed 
and '2 15 for carriage return, are represented in Figure 10-2 to illustrate use of ASCII 
format. 
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CHANNEL 
NUMBERS 




ASR-33 TYPEWRITER 
CONTROL CODES 



POSITION 
VALUES 



!• O fo l 

O • BIT GROUP 3<02 

• O [0 4 
oo oo oooo oooo oo oooooooooo oooooo ooooooo 

• • fo I 

O O BIT GROUP 2 < O 2 

O O 1 O 4 

° 2 BIT GROUP I /g X z 



I '212 LINE 



IE FEED 
'215 CARRIAGE RETURN 



• = PUNCHED HOLE 
O = HOLE POSITION 



Figure 10-2. ASCII Format 

Source Tape Preparation 

A DAP- 16 or FORTRAN source-program data line for the ASR-33 is recorded on 
paper tape in ASCII format as follows. 

. . LINE FEED . . . TEXT . . . X-OFF . . . CARRIAGE RETURN. . . 

The text string between the LINE FEED at the beginning of the line and the X-OFF at the 
end of the line is read into the input buffer. The LINE FEED, X-OFF, and CARRIAGE 
RETURN are control characters and are not input as part of the text string. The X-OFF at 
the end of the line (preceding the CARRIAGE RETURN) is necessary to be compatible with 
the ASR-33/35 input routines. (The ASR-35 requires a RUBOUT following the CARRIAGE 
RETURN.) If the tapes to be read by the paper tape read subroutine are never to be read 
by the ASR-33/35 tape read routine, the X-OFF (and RUBOUT) may be omitted. 

Whtn preparing a source tape using the ASR-33, depress the LINE FEED key, type 
the desired ASCII record (maximum of 72 characters), and then depress the X-OFF and 
CARRIAGE RETURN keys. Repeat this process for each record. If a character is 
punched erroneously, depress the back space and RUBOUT keys and proceed with the 
rest of the line. If a line is punched erroneously, depress the Left Arrow, X-OFF, and 
CARRIAGE RETURN keys. Source tapes punched using the ASR-35 are prepared in a 
similar manner except that the maximum number of characters per record is 75, and 
the RUBOUT key must be punched after the RETURN key. 
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Tabs may be used to compress the data, much as tabs are used on a typewriter. 
The backslash character (\) f 334 is used as a tab code. The backslash is punched on the 
ASR-33/35 as an upper case L. (FORM), Tabs may be used whenever a string of spaces 
precedes a TAB STOP. The tab is punched in place of the spaces. Another way to describe 
the backslash is that it is used as a field delimiter. For example, the backslash is 
ordinarily used when the location, operation, or variable field is not present. 

The ASCII paper tape read subroutine (I$AA) will assume, if not initialized, that 
there are three tab positions corresponding to character positions 6, 12, and 30 (DAP- 16 
source code format). 

The END OF MESSAGE (EOM) record has the following format. 

. . . X-OFF EOM (EOM is ! 203 and is punched by using 
the CONTROL KEY with the letter C). 

The paper tape read subroutine will read one line of data per entry. If an end of 
message code ( ! 203) is encountered at any point in the line, the end of message return will 
be taken, otherwise, the normal return is taken when a carriage return is encountered. 
The end of message code is usually used as a unit record following the last data line to 
be read. 

If the data line exceeds the length of the data buffer, those characters in excess 
will be ignored. No error indication will be given. Similarly, if a tab is encountered 
after the last tab-stop has been passed,the tab will be treated as a space. No error indica- 
tion will be given. The data line may be shorter than the length of the data buffer in which 
case, the buffer is filled out with spaces. 

Figure 10-3 shows a portion of an actual assembly listing (DAP-Test Program) 
along with one line of corresponding source code punched on paper tape. 

4/6/6 Format 

The 4/6/6 format, in which object programs are punched is a binary code that uses 
three frames to define one 1 6-bit word. As illustrated in Figure 10-4, bits 1 -4 of a 16-bit 
word are encoded to make up the first frame, 5-10 the second frame, and 11-16 the third 
frame. Control codes that are punched in ASCII format precede and follow each block of 
16-bit words encoded in 4/6/6 format and use only one frame each. Each data block begins 
with an SOM ('201) and ends with a DC4 (or X-OFF »223). 

When a frame is punched, channels 6 and 7 are ordinarily left blank. This is done 
so that a frame will not print when read by the ASR. However, certain six-bit patterns 
correspond to control functions, which if executed by the ASR, would interfere with 
further reading of this tape. Therefore, these (eight) six-bit groups are translated 
according to Table 10-1 before being punched. A tape punched using this translation 
will not type anything when read in by the ASR. Hence, the 4/6/6 format is sometimes 
called the "Invisible Format." 
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212 LINE FEED 




223 X-OFF(END OF MSG] 
215 CARRIAGE RETURN 
212 LINE FEED 



1 ••• •••• • • •• •••••••• 

•••••»•••••••••• • • •••••••• 

' • ' ••• •••• • • 



252 



301 



Of 01 
0002 

0003 
4 
0005 
0006 
0007 
06 

o o o y 

G 1 3 

o by l 



o o o 1 o 
oooii 

12 

13 
14 

m ai5 



* 0^)00-001-6504 (DAP-TEST) 7011*57 A 

* 5 I ART OBJECT PROGRAM AT OCTAL 10 

* 

* PROGRAM SHOULD TYPE 'O.K.* AND HALT 



2 00 07 4 

On 000 
14 4 

1 Oo 0C076 
12 0C0 
1 011 



:jPG 

I. OA 
hTA 
CR A 
ERA 
IPS 
J MP 
CAS 



* 10 

no 



TT+1 * 1 



*-2 

P K 5 M 



COMPUTE CHECKSUM 



Figure 10-3. DAP- 16 Source Code Punched in ASCII 



17 77 77 



LAST SIX BITS ENCODED ■ 

NEXT SIX BITS ENCODED- 

FIRST FOUR BITS ENCODED- 



CHANNEL 

NUMBERS 




ill 



201 

START CODE 



w \r 



223 
X-OFF 



OOO " • • ••• • 

OOO • • ••• • 

OOO ••• 

OOOOOO OOO OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO) 

OOO # •••• 

ooo mm mm • 

OOO 
OOO 

— — --* — ' — — U Ai U " 



16- BIT WORD 



Xsr^T 




m = PUNCHED HOLE 
O = HOLE POSITION 



N 00 OO OO 



X I2 61 32 



Figure 10-4. 4/6/6 Format 



10-4 



Table 10-1. 
4/6/6 Translations 



Intended 
4 or 6 Bits 


Is Converted to 

Frame 


Possible Ambiguity with 
ASR-33/35 Control 


05 or 45 


174 or 374, respectively 


WRU 


12 or 52 


175 or 375 


LF 


21 or 62 


176 or 376 


X-ON 


23 or 63 


177 or 377 


X-OFF 



In Figure 10-5, the instructions at address 00024 (data word 13 on the tape) when 
encoded without translation would result in an '45 being read by the ASR-33/35. The 
'45 is the WRU control code and would trigger the answer -back drum, This ambiguity 
is resolved however by the translation. (Note in Figure 10-5 that channels 6 and 7 are 
punched in the translation.) 

Object tapes that are produced by both the DAP assembly and the FORTRAN com- 
piling process are punched in the binary 4/6/6 format. Within each block of object code, 
there is a variable-length sequence of data words. There are a number of different types 
of block, and they are defined in Section IV of the DAP- 16 Manual, 3C Doc. No. 
130071629. Object tapes generated in the 4/6/6 format are accepted by and compatible 
with both the DDP-516 standard and expanded loaders. 

Figure 10-5 shows a portion of an actual assembly listing (DAP-TEST Program) 
along with corresponding object code punched in paper tape. As explained in the DAP 
Manual, the first 4/6/6 group after the start code defines the block type. This particular 
block type is 0-4 (000400), or a data block. The next 4/6/6 group specifies the number of 
data words in the data block. In this case there are 72 ft words in the data block. The 
words are interpreted as per the format for this block type given in the DAP Manual. 
In block type 0-4 the remaining bits are grouped into groups of 24 bits each. These 
groups are formed by using 16 bits of one 4/6/6 group and the first 8 bits of a second 
4/6/6 group. The remaining 8 bits of the second 4/6/6 group and 16 bits of a third 
4/6/6 group are used to form the second 24-bit group. 

In the example given in Figure 10-5, the first 24 -bit group is 

000010000000000111011001 

The DAP- 16 Manual (3C Doc. No. 130071629) further explains the meaning of each 24-bit 
group, based on the last three bits. This one converts to the LDA instruction at address 
00010 as follows. 




Relocation Bits 



000 000 000 111 011 



Address 



001 



00073 



Standard 0-4 Type 
Data Word Format 
(Memory Reference 
Indicator) 
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DATA WORDS 



-"^ 








2 






O 


UJ 

a 
>- 


1 


Si 

o 

3 


3 


d 


1- 

cc 


CD 


z 


u. 



/ FIRST DATA WORD 

/ooo/oio/ooo/ooo/ooo/i 1 1 /oi i/ooi 

I i 



/ SECOND DATA WORD \ 

ooo/ 1 oo/ooo/ooo/ooo/ OOO/OOO/OO I 



FT 



OP- CODE 



yo 02 



ADDRESS 

— r- 

00073 



) 



0001 
0002 
0003 
0004 
U005 
3006 
0007 

0008 00010 

0009 00011 

0010 00012 

0011 00013 

0012 00014 

0013 00015 

0014 00016 
^015 00017 
C016 00020 

0017 00021 

0018 00022 

0019 00023 

0020 00024 
--"»« 10025 




C500-001-6504 (DAP-TEST) 7011657 A 
START OBJECT PROGRAM AT OCTAL 10 



PROGRAM SHOULD TYPE *O.K. # AND HALT 



(0 02 00073, 
( 04 00000 

140040 

1 05 00075 

12 00000 

01 00013 

11 00076 

oooooo 

01 00022 

000000 

02 00041 

04 00000 

1 02 00045 TTTT LOA 
34 0104 SKS 

•"»« non?* 




COMPUTE CHECKSUM 



WRONG SUM 
RIGHT SUM 
TYPE 'O.K.* 



Figure 10-5. DAP-16 Object Code Punched in 4/6/6 (Invisible) Format 
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